共用方式為


SqlCeCommand.CommandText 屬性

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

命名空間:  System.Data.SqlServerCe
組件:  System.Data.SqlServerCe (在 System.Data.SqlServerCe.dll 中)

語法

'宣告
Public Overrides Property CommandText As String
    Get
    Set
'用途
Dim instance As SqlCeCommand
Dim value As String

value = instance.CommandText

instance.CommandText = value
public override string CommandText { get; set; }
public:
virtual property String^ CommandText {
    String^ get () override;
    void set (String^ value) override;
}
abstract CommandText : string with get, set
override CommandText : string with get, set
override function get CommandText () : String
override function set CommandText (value : String)

屬性值

型別:System.String
要執行的 SQL 陳述式或要開啟之基底資料表的名稱。預設值為空字串。

實作

IDbCommand.CommandText

備註

CommandType 屬性設定為 TableDirect 時,CommandText 屬性應該設定為要存取之資料表的名稱。TableDirect 存取是從 SQL Server Compact 中擷取資料的最快方式。如果任何具名的資料表包含任何特殊字元,則您可能需要使用逸出字元 (Escape Character) 語法。當您呼叫其中一個 Execute 方法時,將傳回具名資料表的所有資料列和資料行,或傳回資料表。

如果目前的連接正在執行「執行」或「擷取」作業,您就無法設定 ConnectionCommandType 和 CommandText 屬性。

CommandType 設定為 Text 時,.NET Compact Framework Data Provider for SQL Server Compact 可支援用來將參數傳遞給 SqlCeCommand 呼叫之 SQL 陳述式的具名參數。例如:

SELECT * FROM Customers WHERE CustomerID = @customerID

Data Provider for SQL Server Compact 也不支援批次查詢。命令必須遵照以下型式:SELECT * FROM Customers 而不是 SELECT * FROM Customers; SELECT * FROM Orders.如果您使用的是針對 System.Data.SqlClient 所產生的程式碼,則可能必須修改查詢,以符合這個限制。

使用 RDA 已啟用的複寫時,指定 INSERT 查詢的資料行名稱。RDA 追蹤資料表包含系統產生的資料行,將會變更您所預期查詢之資料行的計數。如果您沒有指定資料行名稱而 INSERT 陳述式中的資料行數目與資料表中的資料行數目不同,INSERT 便會失敗。

範例

下列範例會建立 SqlCeCommand,並設定 CommandText 和其他屬性。

Dim cmd As SqlCeCommand = conn.CreateCommand()
cmd.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
cmd.CommandType = CommandType.Text
cmd.UpdatedRowSource = UpdateRowSource.Both
SqlCeCommand cmd = conn.CreateCommand();
cmd.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
cmd.CommandType = CommandType.Text;
cmd.UpdatedRowSource = UpdateRowSource.Both;

請參閱

參考

SqlCeCommand 類別

System.Data.SqlServerCe 命名空間

Connection

CommandType