SqlCeCommand クラス

  • [アーティクル]

データ ソースに対して実行する SQL ステートメントを表します。

継承階層

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbCommand
        System.Data.SqlServerCe.SqlCeCommand

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

構文

'宣言
Public NotInheritable Class SqlCeCommand _
    Inherits DbCommand _
    Implements ICloneable
'使用
Dim instance As SqlCeCommand

public sealed class SqlCeCommand : DbCommand, 
    ICloneable

public ref class SqlCeCommand sealed : public DbCommand, 
    ICloneable

[<SealedAttribute>]
type SqlCeCommand =  
    class
        inherit DbCommand
        interface ICloneable
    end

public final class SqlCeCommand extends DbCommand implements ICloneable

SqlCeCommand 型は、以下のメンバーを公開しています。

コンストラクター

  名前 説明
パブリック メソッド SqlCeCommand() SqlCeCommand クラスの新しいインスタンスを初期化します。
パブリック メソッド SqlCeCommand(String) クエリ テキストを指定して、SqlCeCommand クラスの新しいインスタンスを初期化します。
パブリック メソッド SqlCeCommand(String, SqlCeConnection) クエリ テキストと SqlCeConnection を指定して、SqlCeCommand クラスの新しいインスタンスを初期化します。
パブリック メソッド SqlCeCommand(String, SqlCeConnection, SqlCeTransaction) クエリ テキスト、SqlCeConnection、および SqlCeTransaction を指定して、SqlCeCommand クラスの新しいインスタンスを初期化します。

Top

プロパティ

  名前 説明
プロテクト プロパティ CanRaiseEvents (Component から継承されます。)
パブリック プロパティ CommandText データ ソースで実行する SQL ステートメントを取得または設定します。 (DbCommand.CommandText をオーバーライドします。)
パブリック プロパティ CommandTimeout コマンドを実行する試みを終了してエラーが生成されるまでの待機時間を取得または設定します。 (DbCommand.CommandTimeout をオーバーライドします。)
パブリック プロパティ CommandType CommandText プロパティの解釈方法を示す値を取得または設定します。 (DbCommand.CommandType をオーバーライドします。)
パブリック プロパティ Connection この SqlCeCommand のインスタンスで使用する SqlCeConnection を取得または設定します。
パブリック プロパティ Container (Component から継承されます。)
プロテクト プロパティ DbConnection (DbCommand から継承されます。)
プロテクト プロパティ DbParameterCollection (DbCommand から継承されます。)
プロテクト プロパティ DbTransaction (DbCommand から継承されます。)
プロテクト プロパティ DesignMode (Component から継承されます。)
パブリック プロパティ DesignTimeVisible 取得操作では、必ず false が返されます。設定操作では、必ず NotSupportedException がスローされます。 (DbCommand.DesignTimeVisible をオーバーライドします。)
プロテクト プロパティ Events (Component から継承されます。)
パブリック プロパティ IndexName 開くインデックスを指定します。
パブリック プロパティ Parameters SqlCeParameterCollection を取得します。
パブリック プロパティ Site (Component から継承されます。)
パブリック プロパティ Transaction SqlCeCommand を実行するトランザクションを取得または設定します。
パブリック プロパティ UpdatedRowSource DbDataAdapter の Update メソッドで使用するときに、コマンドの結果を DataRow に適用する方法を取得または設定します。このプロパティは、.NET Compact Framework Data Provider for SQL Server Compact では使用しないでください。 (DbCommand.UpdatedRowSource をオーバーライドします。)

Top

メソッド

  名前 説明
パブリック メソッド Cancel SqlCeCommand の実行のキャンセルを試行します。 (DbCommand.Cancel() をオーバーライドします。)
プロテクト メソッド CreateDbParameter (DbCommand から継承されます。)
パブリック メソッド CreateObjRef (MarshalByRefObject から継承されます。)
パブリック メソッド CreateParameter SqlCeParameter オブジェクトの新しいインスタンスを作成します。
パブリック メソッド Dispose() (Component から継承されます。)
プロテクト メソッド Dispose(Boolean) (Component から継承されます。)
パブリック メソッド Equals (Object から継承されます。)
プロテクト メソッド ExecuteDbDataReader (DbCommand から継承されます。)
パブリック メソッド ExecuteNonQuery SqlCeConnection に対して SQL ステートメントを実行し、影響を受けた行数を返します。 (DbCommand.ExecuteNonQuery() をオーバーライドします。)
パブリック メソッド ExecuteReader() CommandText を Connection に送信し、SqlCeDataReader を構築します。
パブリック メソッド ExecuteReader(CommandBehavior) CommandText を Connection に送信し、CommandBehavior 値のいずれかを使用して SqlCeDataReader を構築します。
パブリック メソッド ExecuteResultSet(ResultSetOptions) CommandText を Connection に送信し、ResultSetOptions を使用して SqlCeResultSet を構築します。
パブリック メソッド ExecuteResultSet(ResultSetOptions, SqlCeResultSet) CommandText を Connection に送信し、ResultSetOptions を使用して SqlCeResultSet を構築します。
パブリック メソッド ExecuteScalar クエリを実行し、そのクエリが返す結果セットの最初の行にある最初の列を返します。残りの列または行は無視されます。 (DbCommand.ExecuteScalar() をオーバーライドします。)
プロテクト メソッド Finalize (Component から継承されます。)
パブリック メソッド GetHashCode (Object から継承されます。)
パブリック メソッド GetLifetimeService (MarshalByRefObject から継承されます。)
プロテクト メソッド GetService (Component から継承されます。)
パブリック メソッド GetType (Object から継承されます。)
パブリック メソッド InitializeLifetimeService (MarshalByRefObject から継承されます。)
プロテクト メソッド MemberwiseClone() (Object から継承されます。)
プロテクト メソッド MemberwiseClone(Boolean) (MarshalByRefObject から継承されます。)
パブリック メソッド Prepare 準備された (コンパイル済みの) バージョンのコマンドをデータ ソースに作成します。 (DbCommand.Prepare() をオーバーライドします。)
パブリック メソッド SetRange SqlCeDataReader が読み込む行セットを制限します。
パブリック メソッド ToString (Component から継承されます。)

Top

イベント

  名前 説明
パブリック イベント Disposed (Component から継承されます。)

Top

明示的なインターフェイスの実装

  名前 説明
明示的なインターフェイスの実装プライベート メソッド ICloneable.Clone
明示的なインターフェイスの実装プライベート プロパティ IDbCommand.Connection (DbCommand から継承されます。)
明示的なインターフェイスの実装プライベート メソッド IDbCommand.CreateParameter (DbCommand から継承されます。)
明示的なインターフェイスの実装プライベート メソッド IDbCommand.ExecuteReader() (DbCommand から継承されます。)
明示的なインターフェイスの実装プライベート メソッド IDbCommand.ExecuteReader(CommandBehavior) (DbCommand から継承されます。)
明示的なインターフェイスの実装プライベート プロパティ IDbCommand.Parameters (DbCommand から継承されます。)
明示的なインターフェイスの実装プライベート プロパティ IDbCommand.Transaction (DbCommand から継承されます。)

Top

説明

SqlCeCommand のインスタンスを作成すると、読み書き可能なプロパティが初期値に設定されます。これらの初期値の一覧については、SqlCeCommand コンストラクターのトピックを参照してください。

SqlCeCommand には、データ ソースに対してコマンドを実行するための、次のメソッドがあります。

項目

説明

ExecuteReader

行を返すコマンドを実行します。

ExecuteNonQuery

INSERT、DELETE、UPDATE ステートメントなどの SQL コマンドを実行します。

ExecuteScalar

データベースから単一の値 (集計値など) を取得します。

ExecuteResultSet

コマンドを実行して、結果セットを返します。

また、Data Provider for SQL Server Compact では、バッチ クエリをサポートしていません。コマンドは、次の形式で指定します。

Select * from Customers 次の形式は、使用しません。Select * from Customers; Select * from Orders;

System.Data.SqlClient 用に生成されたコードを使用する場合は、必要に応じて、この制約に準拠するようにクエリを変更します。

SQL Server Compact では、複数のコマンドによる同一接続の共有、および複数の同時接続がサポートされます。したがって、同じ接続で SqlCeDataReader の複数のインスタンスを使用できます。この動作は、System.Data.SqlClient の動作とは異なります。

SqlCeCommand を実行するメソッドで致命的な SqlCeException が生成された場合、SqlCeConnection が閉じられる可能性があります。ユーザーは接続を再び開いて、処理を継続できます。

使用例

SqlCeCommand を SqlCeConnection と共に使用して、データベースから行を選択する例を次に示します。

Dim query As String = "SELECT [Order ID], [Customer] FROM Orders"
Dim conn As New SqlCeConnection(connString)
Dim cmd As New SqlCeCommand(query, conn)

conn.Open()
Dim rdr As SqlCeDataReader = cmd.ExecuteReader()

Try
    ' Iterate through the results
    '
    While rdr.Read()
        Dim val1 As Integer = rdr.GetInt32(0)
        Dim val2 As String = rdr.GetString(1)
    End While
Finally
    ' Always call Close when done reading
    '
    rdr.Close()

    ' Always call Close when done reading
    '
    conn.Close()
End Try

string query = "SELECT [Order ID], [Customer] FROM Orders";
SqlCeConnection conn = new SqlCeConnection(connString);
SqlCeCommand cmd = new SqlCeCommand(query, conn);

conn.Open();
SqlCeDataReader rdr = cmd.ExecuteReader();

try
{
    // Iterate through the results
    //
    while (rdr.Read())
    {
        int val1 = rdr.GetInt32(0);
        string val2 = rdr.GetString(1);
    }
}
finally
{
    // Always call Close when done reading
    //
    rdr.Close();

    // Always call Close when done reading
    //
    conn.Close();
}

スレッド セーフ

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

関連項目

参照

System.Data.SqlServerCe 名前空間

SqlCeDataAdapter

SqlCeConnection