SqlCeCommand.CommandText Property

データ ソースで実行する SQL ステートメントを取得または設定します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)

構文

'宣言
Public Overrides Property CommandText As String

public override string CommandText { get; set; }

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

/** @property */
public String get_CommandText ()

/** @property */
public void set_CommandText (String value)

public override function get CommandText () : String

public override function set CommandText (value : String)

プロパティ値

実行する SQL ステートメント、または開くベース テーブルの名前。既定値は空の文字列です。

解説

CommandType プロパティを TableDirect に設定した場合、CommandText プロパティは、アクセスするテーブルの名前に設定する必要があります。TableDirect アクセスは、SQL Server Compact 3.5 から最短時間でデータを取得する方法です。テーブル名に特殊文字が含まれている場合は、エスケープ文字構文を使用する必要があります。いずれかの Execute メソッドを呼び出すと、指定したテーブルのすべての行および列が返されます。

現在の接続で Execute 操作または Fetch 操作が実行中の場合は、Connection、CommandType、および CommandText の各プロパティは設定できません。

CommandType を Text に設定した場合、.NET Compact Framework Data Provider for SQL Server Compact 3.5 では、SqlCeCommand から呼び出された SQL ステートメントに名前付きパラメータを利用してパラメータを渡すことができます。その例を次に示します。

SELECT * FROM Customers WHERE CustomerID = @customerID

また、Data Provider for SQL Server Compact 3.5 では、バッチ クエリをサポートしていません。コマンドは 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;

スレッド セーフ

この型の public static (Visual Basic では Shared ) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

Windows Vista、Windows Mobile 5.0、Windows XP Professional with Service Pack 2 (SP2)、Windows Server 2003、Windows Mobile 2003 for Pocket PC、Windows CE 5.0
バージョン情報
.NET Framework および .NET Compact Framework
3.5 でサポート
.NET Framework
3.0 でサポート
.NET Compact Framework および .Net Framework
2.0 でサポート

参照

リファレンス

SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace
Connection
CommandType