CommandText 屬性 （ADO）

表示要針對提供者發出之命令的文字。

設定和傳回值

取得或設定包含提供者命令的 String 值，例如 SQL 語句、數據表名稱、相對 URL 或預存過程調用。 默認值為空字串 （“” ）。

言論

使用 CommandText 屬性來設定或傳回命令的文字，Command 物件表示。 這通常是 SQL 語句，但也可以是提供者所辨識的任何其他命令語句類型，例如預存過程調用。 SQL 語句必須是提供者查詢處理器所支援的特定方言或版本。

如果 Command 物件的 Prepared 屬性設定為 true True，且當您 設定 commandText 属性時，Command 物件會繫結至開啟的連接， 當您呼叫 Execute 或 Open 方法時，ADO 會準備查詢（也就是提供者所儲存的查詢編譯形式）。

根據 CommandType 屬性設定，ADO 可能會改變 CommandText 屬性。 您可以隨時讀取 CommandText 屬性，以查看 ADO 在執行期間將使用的實際命令文字。

使用 CommandText 屬性來設定或傳回指定資源的相對 URL，例如檔案或目錄。 資源相對於絕對 URL 明確指定的位置，或由開放式 Connection 物件隱含指定的位置。

注意

使用 HTTP 配置的 URL 會自動叫用 Microsoft OLE DB Provider for Internet Publishing。 如需詳細資訊，請參閱 絕對和相對URL。

適用於

Command 物件 （ADO）

另請參閱

ActiveConnection、CommandText、CommandTimeout、CommandType、Size 和 Direction 属性範例 （VB）
ActiveConnection、CommandText、CommandTimeout、CommandType、Size 和 Direction 属性範例 （VC++）
Requery 方法
ActiveConnection、CommandText、CommandTimeout、CommandType、Size 和 Direction 属性範例 （JScript）