Execute-Methode (ADO-Verbindung)
Führt die angegebene Abfrage, SQL-Anweisung, gespeicherte Prozedur oder 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.
Hinweise
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. Wenn der Befehl keine Ergebnisse zurückgibt (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.
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.