次の方法で共有


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 から最短時間でデータを取得する方法です。テーブル名に特殊文字が含まれている場合は、エスケープ文字構文を使用する必要があります。いずれかの Execute メソッドを呼び出すと、指定したテーブルのすべての行および列が返されます。

現在の接続で Execute 操作または Fetch 操作が実行中の場合は、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