CommandText-Eigenschaft (ADO)

Gilt für: Access 2013, Office 2013

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

Einstellungen und Rückgabewerte

Mit dieser Eigenschaft wird ein String-Wert festgelegt oder zurückgegeben, der einen Anbieterbefehl enthält, z. B. eine SQL-Anweisung, einen Tabellennamen, eine relative URL oder den Aufruf einer gespeicherten Prozedur. Die Standardeinstellung ist "" (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, aber es kann sich auch um einen beliebigen anderen Typ von Befehlsanweisung handeln, der vom Anbieter erkannt wird, z. B. ein Aufruf einer gespeicherten Prozedur. Eine SQL-Anweisung muss den bestimmten Dialekt oder die version aufweisen, die vom Abfrageprozessor des Anbieters unterstützt wird.

Falls die Prepared-Eigenschaft des Command -Objekts auf True festgelegt ist und das Command -Objekt an eine geöffnete Verbindung gebunden ist, wenn Sie die CommandText -Eigenschaft festlegen, bereitet ADO beim Aufrufen der Execute- oder Open -Methode die Abfrage vor (d. h. eine kompilierte Form der vom Anbieter gespeicherten Abfrage).

In Abhängigkeit von der Einstellung für die CommandType-Eigenschaft wird die CommandText -Eigenschaft möglicherweise von ADO geändert. Sie können die CommandText -Eigenschaft jederzeit lesen, um den tatsächlichen Befehlstext anzuzeigen, den ADO bei der Ausführung verwenden wird.

Mit der CommandText-Eigenschaft können Sie eine relative URL festlegen oder zurückgeben, die eine Ressource angibt, wie z. B. eine Datei oder ein Verzeichnis. Die Ressource ist relativ zu einem explizit durch eine absolute URL angegebenen Speicherort oder implizit zu einem geöffneten Connection-Objekt.