CommandText-Eigenschaft (ADO)

Gibt den Text eines Befehls an, der an einen Anbieter gesendet werden soll.

Einstellungen und Rückgabewerte

Dient zum Abrufen oder Festlegen eines String-Werts , der einen Anbieterbefehl enthält, z. B. eine SQL-Anweisung, einen Tabellennamen, eine relative URL oder einen Aufruf einer gespeicherten Prozedur. Der Standardwert ist eine leere Zeichenfolge ("").

Hinweise

Verwenden Sie die CommandText-Eigenschaft, um den Text eines Befehls festzulegen oder zurückzugeben, der durch ein Command-Objekt dargestellt wird. In der Regel handelt es sich dabei um eine SQL-Anweisung, kann aber auch eine beliebige andere Art von Befehlsanweisung sein, die vom Anbieter erkannt wird, z. B. ein Aufruf einer gespeicherten Prozedur. Eine SQL-Anweisung muss dem bestimmten Dialekt oder der vom Abfrageprozessor des Anbieters unterstützten Version entsprechen.

Wenn die Prepared-Eigenschaft des Command-Objekts auf True festgelegt ist und das Command-Objekt an eine offene Verbindung gebunden ist, wenn Sie die CommandText-Eigenschaft festlegen, bereitet ADO die Abfrage vor (d. h. eine kompilierte Form der Abfrage, die vom Anbieter gespeichert wird), wenn Sie die Methode Execute oder Open aufrufen.

Abhängig von der Einstellung der CommandType-Eigenschaft kann ADO die CommandText-Eigenschaft ändern. Sie können die CommandText-Eigenschaft jederzeit lesen, um den tatsächlichen Befehlstext anzuzeigen, den ADO während der Ausführung verwendet.

Verwenden Sie die CommandText-Eigenschaft, um eine relative URL festzulegen oder zurückzugeben, die eine Ressource angibt, z. B. eine Datei oder ein Verzeichnis. Die Ressource ist relativ zu einem Ort, der explizit von einer absoluten URL oder implizit von einem geöffneten Connection-Objekt angegeben wird.

Gilt für

Command-Objekt (ADO)

Weitere Informationen

Beispiel für die ActiveConnection-, CommandText-, CommandTimeout-, CommandType-, Size- und Direction-Eigenschaften (VB)
Beispiel für die ActiveConnection-, CommandText-, CommandTimeout-, CommandType-, Size- und Direction-Eigenschaften (VC++)
Requery-Methode
Beispiel für die ActiveConnection-, CommandText-, CommandTimeout-, CommandType-, Size- und Direction-Eigenschaften (JScript)