語言

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 方法時,指令會執行這個儲存程序。

當 CommandType 設定為 TableDirect時,屬性 CommandType 應設定為要存取的資料表名稱。 如果任何命名的資料表包含特殊字元,使用者可能需要使用跳脫字元語法。 當你呼叫其中一個 Execute 方法時,命名資料表的所有列和欄都會被回傳。

如果目前連線正在執行執行或擷取操作,你就無法設定 Connection、 CommandType和 CommandText 屬性。

OLE DB.NET 提供者不支援將參數傳給 SQL 陳述式或當 設定為 OleDbCommand時呼叫CommandTypeText的儲存程序的命名參數。 此時必須使用問號(?)佔位符。 例如:

SELECT * FROM Customers WHERE CustomerID = ?

因此,物件加入的OleDbParameter順序OleDbParameterCollection必須直接對應該參數的問號佔位符的位置。

欲了解更多資訊,請參閱 「參數與參數資料型態的配置」。

適用於

另請參閱