Execute-Methode (ADO-Verbindung)

  • Artikel

Führt die angegebene Abfrage, SQL-Anweisung, gespeicherte Prozedur oder den anbieterspezifischen Text aus

Syntax

  
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)  
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)

Rückgabewert

Gibt eine Recordset Object (ADO)-Objektreferenz zurück

Parameter

CommandText
Ein String-Wert, der die SQL-Anweisung, die gespeicherte Prozedur, eine URL oder einen anbieterspezifischen Text enthält, der ausgeführt werden soll Optional können Tabellennamen verwendet werden, jedoch nur, wenn der Anbieter SQL-fähig ist. Wenn z. B. der Tabellenname „Customers“ verwendet wird, wird ADO automatisch die SQL Select-Standardsyntax dem Formular voranstellen und „SELECT * FROM Customers“ als Transact-SQL-Anweisung an den Anbieter übergeben.

RecordsAffected
Optional. Eine Long-Variable, an die der Anbieter die Anzahl von Datensätzen zurückgibt, die vom Vorgang betroffen waren

Optionen
Optional. Ein Long-Wert, der angibt, wie der Anbieter das „CommandText“-Argument auswerten soll. Dies kann eine Bitmaske eines oder mehrerer CommandTypeEnum- oder ExecuteOptionEnum-Werte sein.

Hinweis Verwenden Sie den ExecuteOptionEnum-Wert adExecuteNoRecords, um die Leistung zu verbessern, indem Sie interne Prozesse für Anwendungen minimieren, die Sie von Visual Basic 6.0 portieren.

Verwenden Sie adExecuteStream nicht mit der Execute-Methode eines Connection-Objekts.

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

Bemerkungen

Wenn Sie die Execute-Methode für ein Connection Object (ADO)-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 Ergebnisse, die die Ausführung generiert, in einem neuen Recordset-Objekt gespeichert. Bei einem Befehl, der 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 die „Execute“-Methode ein geschlossenes Recordset zurück.

Beim zurückgegebenen Recordset-Objekt handelt es sich immer um einen schreibgeschützten Vorwärtscursor. Wenn Sie ein Recordset-Objekt mit mehr Funktionalität benötigen, erstellen Sie zuerst ein Recordset-Objekt mit den gewünschten Eigenschafteneinstellungen, und verwenden Sie dann die Open Method (ADO Recordset)-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 sich um Standard-SQL-Syntax oder ein beliebiges spezielles Befehlsformat handeln, das der Anbieter unterstützt.

Ein „ExecuteComplete“-Ereignis wird ausgegeben, wenn dieser Vorgang abgeschlossen wird.

Hinweis

URLs, die das HTTP-Schema verwenden, rufen automatisch den Microsoft OLE DB-Anbieter für Internet-Publishing auf. Weitere Informationen finden Sie unter Absolute und relative URLs.

Gilt für

Connection-Objekt (ADO)