CRecordset::Requery

wirtualne BOOL PonówKwerendę ( );
rzut ( CDBException, CMemoryException );

Wartość zwracany

Niezerowa, jeśli zestaw rekordów została pomyślnie odbudował; inny sposób 0.

Uwagi

Wywołanie tej funkcji członek odbudować (odświeżanie) zestawu rekordów. Jeśli zwracane są wszystkie rekordy, pierwszy rekord staje się bieżącym rekordzie.

Aby zestaw rekordów w celu odzwierciedlenia uzupełnień i skreśleń, które użytkownik lub inni użytkownicy wnoszą do źródła danych należy ponownie utworzyć zestaw rekordów, wywołując PonówKwerendę. Jeżeli zestaw rekordów jest pobierany, automatycznie odzwierciedla aktualizacje, które użytkownik lub inni użytkownicy składają swoje istniejące rekordy (ale nie dodatków). Jeżeli zestaw rekordów jest migawka, należy wywołać PonówKwerendę do odzwierciedlenia zmian przez innych użytkowników, jak również uzupełnień i skreśleń.

Dynamiczny lub migawkę Dzwoń PonówKwerendę chcesz odbudować rekordów przy użyciu nowego filtru, sortowania lub nowe wartości parametrów. Ustawić nowy filtr lub właściwość sortowania przypisując nowe wartości m_strFilter i m_strSort przed wywołaniem Requery. Ustaw nowe parametry przypisując nowe wartości dla parametru danych członków przed wywołaniem Requery. Ciągi filtrowanie i sortowanie pozostają bez zmian, można ponownie użyć kwerendy, co znacznie poprawia wydajność.

Jeśli próba odbudować rekordów nie powiedzie się, zestaw rekordów jest zamknięty. Zanim zadzwonisz, Requery, można określić, czy zestaw rekordów można ponowieniu przez wywołanie funkcji członek CanRestart . CanRestart nie gwarantuje, że PonówKwerendę będzie poprawne.

Przestroga   Wywołanie PonówKwerendę dopiero po wywołaniu Open.

Przykład

W tym przykładzie odbudowuje zestawu rekordów, aby zastosować inny porządek sortowania.

/ / Przykład CRecordset::Requery

CCustSet rsCustSet (&NULL);

/ / Otwórz zestaw rekordów
rsCustSet.Open ();

/ / Użyć zestawu rekordów...

/ / Ustaw porządek sortowania i ponowić kwerendę rekordów
rsCustSet.m_strSort = "District, nazwisko";
Jeżeli (! rsCustSet.CanRestart ())
 nbsp; powrotu;    / / Nie można ponowić kwerendę

Jeżeli (! rsCustSet.Requery ())
   / / PonówKwerendę nie powiodło się, dlatego należy podjąć działania

Omówie&nie CRecordset |nbsp; Klasa członków | Wykres hierarchii

Zobacz też CRecordset::CanRestart, CRecordset::m_strFilter, CRecordset::m_strSort

Index