Requery-Methode

  • Artikel

Aktualisiert die Daten in einem Recordset-Objekt durch erneutes Ausführen der Abfrage, auf der das Objekt basiert.

Syntax

  
recordset.Requery Options

Parameter

Optionen
Optional. Eine Bitmaske, die die Werte ExecuteOptionEnum und CommandTypeEnum enthält, die diesen Vorgang beeinflussen.

Hinweis

Wenn Options auf adAsyncExecute festgelegt ist, wird dieser Vorgang asynchron ausgeführt, und ein RecordsetChangeComplete-Ereignis wird beim Abschluss ausgegeben. Die ExecuteOpenEnum-Werte von adExecuteNoRecords oder adExecuteStream dürfen nicht mit Requery verwendet werden.

Bemerkungen

Verwenden Sie die Requery-Methode, um den gesamten Inhalt eines Recordset-Objekts aus der Datenquelle zu aktualisieren, indem Sie den ursprünglichen Befehl erneut anfordern und die Daten ein zweites Mal abrufen. Das Aufrufen dieser Methode entspricht dem Aufrufen der Methoden Close und Open in Folge. Wenn Sie den aktuellen Datensatz bearbeiten oder einen neuen Datensatz hinzufügen, tritt ein Fehler auf.

Wenn das Recordset-Objekt geöffnet ist, sind die Eigenschaften, die die Art des Cursors definieren (CursorType, LockType, MaxRecords usw.) schreibgeschützt. Daher kann die Requery-Methode nur den aktuellen Cursor aktualisieren. Um eine der Cursoreigenschaften zu ändern und die Ergebnisse anzuzeigen, müssen Sie die Close-Methode verwenden, damit die Eigenschaften nicht mehr schreibgeschützt sind. Anschließend können Sie die Eigenschafteneinstellungen ändern und die Open-Methode aufrufen, um den Cursor erneut zu öffnen.

Gilt für

Recordset-Objekt (ADO)

Weitere Informationen

Methoden Execute, Requery und Clear – Beispiel (VB)
Methoden Execute, Requery und Clear – Beispiel (VBScript)
Methoden Execute, Requery und Clear – Beispiel (VC++)
CommandText-Eigenschaft (ADO)