CommandText-Eigenschaft (ADO)

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

Einstellungen und Rückgabewerte

Ruft einen String-Wert ab, der einen Anbieterbefehl enthält, z. B. eine SQL-Anweisung, einen Tabellennamen, eine relative URL oder einen gespeicherten Prozeduraufruf, oder legt diesen fest. Der Standardwert ist eine leere Zeichenfolge ("").

Bemerkungen

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 hierbei um eine SQL-Anweisung, kann aber auch jede andere vom Anbieter erkannte Befehlsanweisung sein, z. B. ein gespeicherter Prozeduraufruf. Eine SQL-Anweisung muss vom jeweiligen Dialekt oder der vom Abfrageprozessor des Anbieters unterstützten Version sein.

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.

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

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)