SqlCeCommand クラス

.NET Framework クラス ライブラリ リファレンス

SqlCeCommand クラス

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

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

Visual Basic (宣言)

Public NotInheritable Class
 SqlCeCommand
    Inherits DbCommand
    Implements ICloneable

Visual Basic (使用法)

Dim instance As SqlCeCommand

C#

public sealed class SqlCeCommand : DbCommand,
 ICloneable

C++

public ref class SqlCeCommand sealed : public
 DbCommand, ICloneable

J#

public final class SqlCeCommand extends DbCommand
 implements ICloneable

JScript

public final class SqlCeCommand extends
 DbCommand implements ICloneable

解説

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

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

項目	説明
ExecuteReader	行を返すコマンドを実行します。
ExecuteNonQuery	INSERT、DELELE、UPDATE ステートメントなどの SQL コマンドを実行します。
ExecuteScalar	データベースから単一の値 (集計値など) を取得します。
ExecuteResultSet	コマンドを実行して、結果セットを返します。

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

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

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

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

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

使用例

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

Visual Basic

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

C#

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();
}

継承階層

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

スレッド セーフ

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

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCeCommand メンバ
System.Data.SqlServerCe 名前空間
SqlCeDataAdapter
SqlCeConnection