CRecordset::Requery

Artykuł
02/27/2013

Przebudowuje (odświeżanie) zestawu rekordów.

virtual BOOL Requery( );

Wartość zwracana

Niezerowa, jeśli zestaw rekordów pomyślnie został przebudowany; 0 inaczej.

Uwagi

Zwracane są wszystkie rekordy, pierwszy rekord staje się bieżącym rekordzie.

Aby zestaw rekordów odzwierciedlić uzupełnień i skreśleń, które ustanawiają źródła danych, należy ponownie utworzyć zestaw rekordów wywołując Requery.Jeśli zestaw rekordów, dynamiczny zestaw wyników, automatycznie odzwierciedla aktualizacje użytkownikom jego istniejących rekordów (ale nie dodatki).Jeżeli zestaw rekordów jest migawki, należy wywołać Requery w celu odzwierciedlenia zmian przez innych użytkowników, jak również uzupełnień i skreśleń.

Dynamiczny lub migawki call Requery dowolnym czasie chcesz odbudować rekordów przy użyciu nowego filtru lub sortowania lub nowych wartości parametru.Ustaw właściwości nowego filtru lub sortowania przypisując nowe wartości do m_strFilter i m_strSort przed wywoływaniem Requery.Ustaw nowe parametry przypisując nowe wartości parametru danych członków przed wywoływaniem Requery.Jeśli filtrowanie i sortowanie ciągi ulegną zmianie, można ponownie użyć kwerendy, która zwiększa wydajność.

Jeśli nie powiedzie się próba odbudować zestawu rekordów, zestaw rekordów jest zamknięty.Przed wywołaniem Requery, można określić, czy zestaw rekordów można ponowieniu wywołując CanRestart funkcji składowej.CanRestartnie gwarantuje, że Requery się powiedzie.

Przestroga
Wywołanie Requery tylko po wywołaniu Otwórz.

Wyjątki

Tej metody można zgłosić wyjątków typu CDBException * i CMemoryException*.

Przykład

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

CCustomer rsCustSet(&m_dbCust);

// Open the recordset
rsCustSet.Open();

// Use the recordset ...

// Set the sort order and Requery the recordset
rsCustSet.m_strSort = _T("L_Name, ContactFirstName");
if(!rsCustSet.CanRestart())
   return;    // Unable to requery

if(!rsCustSet.Requery())
   // Requery failed, so take action
   AfxMessageBox(_T("Requery failed!"));