Execute-Methode (ADO-Befehl)

  • Artikel

Gilt für: Access 2013 | Access 2016

Es wird die Abfrage, SQL-Anweisung oder gespeicherte Prozedur ausgeführt, die in der CommandText-Eigenschaft angegeben ist.

Syntax

Für ein Recordset -returning Command:

Für einen Nicht-Recordset-Rückgabebefehl:

Rückgabewert

Ein Recordset-Objektverweis oder Nothing wird zurückgegeben.

Parameter

  • Betroffene Datensätze

    • Optional. Eine Long-Variable, an die vom Anbieter die Anzahl der von der Operation betroffenen Datensätze zurückgegeben wird. Der RecordsAffected-Parameter gilt nur für Aktionsabfragen oder gespeicherte Prozeduren. RecordsAffected gibt nicht die Anzahl der Datensätze zurück, die von einer Ergebnisrückgabeabfrage oder gespeicherten Prozedur zurückgegeben werden. Verwenden Sie die RecordCount-Eigenschaft , um diese Informationen abzurufen. Die Execute-Methode gibt nicht die richtigen Informationen zurück, wenn sie mit adAsyncExecute verwendet wird. Dies liegt einfach daran, dass bei der asynchronen Ausführung eines Befehls die Anzahl der betroffenen Datensätze zum Zeitpunkt der Rückgabe der Methode möglicherweise noch nicht bekannt ist.

  • Parameter

    • Optional. Ein Variant-Array aus Parameterwerten, das mit einer SQL-Anweisung übergeben wird. (Bei Übergabe in diesem Argument werden durch die Ausgabeparameter nicht die richtigen Werte zurückgegeben.)

  • Optionen

    • Optional. Ein Long-Wert, durch den angegeben wird, wie die CommandText-Eigenschaft des Command-Objekts vom Anbieter ausgewertet werden soll. Kann ein Bitmaskenwert sein, der mit den Werten CommandTypeEnum und/oder ExecuteOptionEnum erstellt wird. Beispielsweise können Sie adCmdText und adExecuteNoRecords kombiniert verwenden, wenn der Wert der CommandText-Eigenschaft von ADO als Text ausgewertet werden soll und angegeben werden soll, dass durch den Befehl alle möglicherweise beim Ausführen des Befehlstexts generierten Datensätze verworfen und nicht zurückgegeben werden sollen.

Hinweise

Durch das Verwenden der Execute-Methode für ein Command-Objekt wird die in der CommandText-Eigenschaft des Objekts angegebene Abfrage ausgeführt. Wenn durch die CommandText-Eigenschaft eine Zeilen zurückgebende Abfrage angegeben wird, werden alle durch die Ausführung generierten Ergebnisse in einem neuen Recordset-Objekt gespeichert. Wenn der Befehl keine Zeilen zurückgebende Abfrage ist, wird vom Anbieter ein geschlossenes Recordset-Objekt zurückgegeben. In manchen Anwendungssprachen können Sie diesen Rückgabewert ignorieren, wenn kein Recordset gewünscht wird.

Wenn die Abfrage Parameter enthält, werden die aktuellen Werte für die Parameter des Command-Objekts verwendet, wenn Sie diese nicht durch mit dem Execute-Aufruf übergebene Parameterwerte außer Kraft setzen. Sie können eine Teilmenge der Parameter außer Kraft setzen, indem Sie neue Werte für einige der Parameter beim Aufrufen der Execute-Methode weglassen. Die Reihenfolge, in der Sie die Parameter angeben, entspricht der Reihenfolge, in der diese von der Methode übergeben werden. Wenn beispielsweise vier (oder mehr) Parameter vorhanden sind und Sie neue Werte nur für den ersten und vierten Parameter übergeben möchten, würden Sie als Parameter-Argument übergeben.

Hinweis

Bei Übergabe im Parameters-Argument werden durch die Ausgabeparameter nicht die richtigen Werte zurückgegeben.

Nach Abschluss der Operation wird ein ExecuteComplete-Ereignis ausgegeben.

Siehe auch

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.