SqlCeCommand クラス

[アーティクル]
05/27/2011

データソースに対して実行する 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) のすべてのメンバーは、スレッドセーフです。インスタンスメンバーの場合は、スレッドセーフであるとは限りません。

次の方法で共有

SqlCeCommand クラス

継承階層

構文

コンストラクター

プロパティ

メソッド

イベント

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

説明

使用例

スレッドセーフ

関連項目

参照

その他のリソース

次の方法で共有

SqlCeCommand クラス

継承階層

構文

コンストラクター

プロパティ

メソッド

イベント

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

説明

使用例

スレッド セーフ

関連項目

参照

その他のリソース

スレッドセーフ