OleDbCommand.CommandText 屬性

定義

命名空間:

System.Data.OleDb

組件:

System.Data.OleDb.dll

套件:

System.Data.OleDb v9.0.0-rc.2.24473.5

來源:

OleDbCommand.cs

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

public:
 virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };

public override string CommandText { get; set; }

member this.CommandText : string with get, set

Public Overrides Property CommandText As String

屬性值

String

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

實作

CommandText

範例

下列範例會建立 並 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 一個方法時，此命令會執行這個預存程式。

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

如果目前的連接正在執行或擷取作業，則無法設定 Connection、 CommandType和 CommandText 屬性。

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

SELECT * FROM Customers WHERE CustomerID = ?

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

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

另請參閱

• 使用命令