CommandText-Eigenschaft (ADO)
Gibt den Text eines Befehls an, der für einen Anbieter ausgegeben 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 die 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 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 geöffnete Verbindung gebunden ist, wenn Sie die eigenschaft CommandText festlegen, ADO bereitet die Abfrage (d. h. ein kompiliertes Formular der Abfrage, die vom Anbieter gespeichert wird) vor, wenn Sie die Methoden Execute oder Open aufrufen.
Je nach einstellung der CommandType-eigenschaft kann ADO die CommandText--Eigenschaft ändern. Sie können die eigenschaft CommandText 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 durch eine absolute URL angegeben wird, oder implizit durch ein geöffnetes Connection-Objekt.
Anmerkung
URLs, die das HTTP-Schema verwenden, rufen automatisch den Microsoft OLE DB-Anbieter für Internet Publishingauf. Weitere Informationen finden Sie unter absoluten und relativen URLs.
Gilt für
Siehe auch
ActiveConnection-, CommandText-, CommandTimeout-, CommandType-, Size- und Direction-Eigenschaft (Vb-Beispiel)
ActiveConnection-, CommandText-, CommandTimeout-, CommandType-, Size- und Direction-Eigenschaft (Beispiel) (VC++)
Requery-Methode
ActiveConnection-, CommandText-, CommandTimeout-, CommandType-, Size- und Direction-Eigenschaft (Beispiel) (JScript)