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 ステートメント、または開くベース テーブルの名前。既定値は空の文字列です。
実装
説明
CommandType プロパティを TableDirect に設定した場合、CommandText プロパティは、アクセスするテーブルの名前に設定する必要があります。TableDirect アクセスは、SQL Server Compact から最短時間でデータを取得する方法です。テーブル名に特殊文字が含まれている場合は、エスケープ文字構文を使用する必要があります。いずれかの Execute メソッドを呼び出すと、指定したテーブルのすべての行および列が返されます。
現在の接続で Execute 操作または Fetch 操作が実行中の場合は、Connection、CommandType、および 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;