CRecordset:: Requery

virtuelle BOOL Requery ( );
werfen ( CDBException, CMemoryException );

Rückgabewert

Ungleich NULL, wenn das Recordset erfolgreich wieder aufgebaut wurde; andernfalls 0.

Bemerkungen

Rufen Sie diese Memberfunktion neu erstellen (Refresh) ein Recordset. Wenn keine Datensätze zurückgegeben werden, wird der erste Datensatz der aktuelle Datensatz.

In Reihenfolge für das Recordset widerspiegeln, die Hinzufügungen und Löschungen, die Sie oder andere Benutzer mit der Datenquelle herstellen, müssen Sie das Recordset neu erstellen, durch Aufrufen von Requery. Falls das Recordset ein Dynaset ist, reflektiert es automatisch Updates, die Sie oder andere Benutzer an ihre vorhandene Datensätze (aber keine Ergänzungen) vornehmen. Wenn das Recordset ein Snapshot ist, müssen Sie entsprechend Änderungen durch andere Benutzer als auch Ergänzungen und Streichungen Requery aufrufen.

Ein Dynaset oder Snapshot rufen Sie Requery jedes Mal Sie das Recordset einen neuen Filter oder sortieren oder neuen Parameterwerte verwenden neu erstellen möchten. Setzen Sie neue Filter oder Sortierfunktion durch Zuweisen neuer Werte M_strFilter und M_strSort vor dem Aufruf von Requery. Festlegen Sie neue Parameter, indem Sie Parameterdatenmember vor dem Aufruf von Requeryneue Werte zuweisen. Wenn die Filtern und Sortieren Zeichenfolgen unverändert sind, können Sie die Abfrage wiederverwenden, die was die Leistung verbessert.

Scheitert der Versuch, das Recordset neu erstellen, wird das Recordset geschlossen. Bevor Sie Requeryaufrufen, können Sie bestimmen, ob das Recordset erneut abgefragt werden kann, indem Sie die CanRestart -Memberfunktion aufrufen. CanRestart garantiert nicht, dass es gelingt Requery.

Vorsicht&Nbsp;Requery rufen Sie auf, nur nachdem Sie Open aufgerufen haben.

Beispiel

In diesem Beispiel erstellt ein Recordset, um eine andere Sortierreihenfolge anwenden.

/ / Beispiel für CRecordset:: Requery

CCustSet RsCustSet (&NULL);

/ / Recordset öffnen
rsCustSet.Open ();

/ / Verwenden Sie das Recordset...

/ / Legen Sie die Sortierreihenfolge und das Recordset neu Abfragen
rsCustSet.m_strSort = "District, Nachname";
Wenn (! rsCustSet.CanRestart ())
 Nbsp; Rückkehr;    / / Abfragen

Wenn (! rsCustSet.Requery ())
   / / Requery fehlgeschlagen, also handeln

CRecordset ÜbersichtMember der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;CRecordset::CanRestart, CRecordset::m_strFilter, CRecordset::m_strSort

Index