共用方式為


OleDbCommand.CommandText 屬性

定義

取得或設定要在資料來源執行的 SQL 陳述式或預存程序。

public:
 virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public:
 property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public override string CommandText { get; set; }
[System.Data.DataSysDescription("DbCommand_CommandText")]
public string CommandText { get; set; }
member this.CommandText : string with get, set
[<System.Data.DataSysDescription("DbCommand_CommandText")>]
member this.CommandText : string with get, set
Public Overrides Property CommandText As String
Public Property CommandText As String

屬性值

要執行的 SQL 陳述式或預存程序。 預設值為空字串。

實作

屬性

範例

下列範例會建立 並 OleDbCommand 設定其部分屬性。

public void CreateMyOleDbCommand()
{
   OleDbCommand command = new OleDbCommand();
   command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
   command.CommandTimeout = 20;
}
Public Sub CreateMyOleDbCommand()
    Dim command As New OleDbCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 20
End Sub

備註

CommandType當屬性設定為 StoredProcedure時,CommandType屬性應該設定為預存程序的名稱。 如果預存程式名稱包含任何特殊字元,則使用者可能需要使用逸出字元語法。 當您呼叫其中 Execute 一個方法時,此命令會執行這個預存程式。

當 設定為 TableDirectCommandTypeCommandType屬性應該設定為要存取的數據表或數據表名稱。 如果使用者有任何具名數據表包含任何特殊字元,則可能需要使用逸出字元語法。 當您呼叫其中 Execute 一個方法時,將會傳回具名數據表或數據表的所有數據列和數據行。

如果目前的連接正在執行或擷取作業,則無法設定 ConnectionCommandTypeCommandText 屬性。

OLE DB.NET Provider 不支援將參數傳遞至 SQL 語句的具名參數,或當 設定為 TextCommandType所呼叫的OleDbCommand預存程式。 在此情況下,必須使用問號 (?) 佔位符。 例如:

SELECT * FROM Customers WHERE CustomerID = ?

因此,加入 OleDbParameterCollection 對象的順序OleDbParameter必須直接對應至 參數的問號佔位元位置。

如需詳細資訊,請參閱 設定參數和參數數據類型

適用於

另請參閱