CommandText 屬性 (ADO)

指出要針對提供者發出的命令文字。

設定和傳回值

取得或設定 String 值，其中包含提供者命令，例如 SQL 語句、數據表名稱、相對 URL 或預存過程調用。預設值為空字串 ("")。

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

如果 Command 物件的 Prepared 屬性設定為 True，且 Command 物件在您設定 CommandText 屬性時繫結至開啟的連接，則當您呼叫 Execute 或 Open 方法時，ADO 會準備查詢 (也就是提供者所儲存的查詢已編譯格式)。

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

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

注意

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