Execute-Methode (ADO-Verbindung)

  • Artikel

Gilt für: Access 2013 | Access 2016

Die angegebene Abfrage, SQL-Anweisung, gespeicherte Prozedur oder der angegebene anbieterspezifische Text wird ausgeführt.

Syntax

Für eine Befehlszeichenfolge, die keine Zeilen zurückgibt:

Verbindung herstellen. ExecuteCommandText, RecordsAffected, Options

Für eine Zeilen zurückgebende Befehlszeichenfolge:

Legen Siedie Recordsetverbindung = fest. Execute( CommandText, RecordsAffected, Options )

Rückgabewert

Ein Recordset-Objektverweis wird zurückgegeben.

Parameter

  • CommandText

    • Ein String-Wert , der die SQL-Anweisung, die gespeicherte Prozedur, eine URL oder den anbieterspezifischen Text enthält, der ausgeführt werden soll. Optional können Tabellennamen verwendet werden, aber nur, wenn der Anbieter SQL-fähig ist. Wenn beispielsweise der Tabellenname "Customers" verwendet wird, stellt ADO automatisch die SQL Select-Standardsyntax voran, um "SELECT * FROM Customers" als T-SQL-Anweisung an den Anbieter zu erstellen und zu übergeben.

  • Betroffene Datensätze

    • Optional. Eine Long-Variable, an die vom Anbieter die Anzahl der von der Operation betroffenen Datensätze zurückgegeben wird.

  • Options

    • Optional. Ein Long-Wert, durch den angegeben wird, wie das CommandText-Argument vom Anbieter ausgewertet werden soll. Kann eine Bitmaske aus einem oder mehreren CommandTypeEnum- oder ExecuteOptionEnum-Werten sein.

Hinweis

Verwenden Sie den ExecuteOptionEnum-Wert adExecuteNoRecords, um durch Minimieren der internen Verarbeitung die Leistung zu verbessern.

Verwenden Sie nicht die CommandTypeEnum-Werte adCmdFile oder adCmdTableDirect mit Execute. Diese Werte können nur als Optionen mit den Methoden Open und Requery eines Recordsets verwendet werden.

HinwBemerkungeneise

Wenn Sie die Execute-Methode für ein Connection-Objekt verwenden, wird jede Abfrage ausgeführt, die Sie an die Methode im CommandText-Argument für die angegebene Verbindung übergeben. Wenn das CommandText-Argument eine Zeilenrückgabeabfrage angibt, werden alle von der Ausführung generierten Ergebnisse in einem neuen Recordset-Objekt gespeichert. Wenn der Befehl keine Ergebnisse zurückgeben soll (z. B. eine SQL UPDATE-Abfrage), gibt der Anbieter Nothing zurück, solange die Option adExecuteNoRecords angegeben ist. Andernfalls gibt Execute ein geschlossenes Recordset zurück.

Das zurückgegebene Recordset-Objekt ist immer ein schreibgeschützter Vorwärtscursor. Wenn Sie ein Recordset-Objekt mit mehr Funktionalität benötigen, erstellen Sie zunächst ein Recordset-Objekt mit den gewünschten Eigenschafteneinstellungen, und verwenden Sie dann die Open-Methode des Recordset-Objekts, um die Abfrage auszuführen und den gewünschten Cursortyp zurückzugeben.

Der Inhalt des CommandText-Arguments ist anbieterspezifisch und kann der SQL-Standardsyntax oder einem speziellen vom Anbieter unterstützten Befehlsformat entsprechen.

Nach Abschluss der Operation wird ein ExecuteComplete-Ereignis ausgegeben.

Hinweis

Bei URLs, die das HTTP-Schema verwenden, wird automatisch der Microsoft OLE DB-Anbieter für Internet Publishing aufgerufen. Weitere Informationen finden Sie unter Absolute and Relative URLs.

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.