SqlCeCommand クラス

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

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

この型のすべてのメンバの一覧については、SqlCeCommand メンバ を参照してください。

System.Object
   System.MarshalByRefObject
      System.Data.SqlServerCe.SqlCeCommand

NotInheritable Public Class SqlCeCommand
   Inherits MarshalByRefObject
   Implements ICloneable, IDbCommand, IDisposable
[C#]
public sealed class SqlCeCommand : MarshalByRefObject, ICloneable,
   IDbCommand, IDisposable
[C++]
public __gc __sealed class SqlCeCommand : public
   MarshalByRefObject, ICloneable, IDbCommand, IDisposable
[JScript]
public class SqlCeCommand extends MarshalByRefObject implements
   ICloneable, IDbCommand, IDisposable

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

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

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

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

CommandTypeText に設定した場合、.NET Compact Framework Data Provider for SQL Server CE では、 SqlCeCommand が SQL ステートメントを呼び出すときに名前付きパラメータを利用してパラメータを渡すことはできません。疑問符 (?) プレースホルダを使用する必要があります。次に例を示します。

SELECT * FROM Customers WHERE CustomerID = ?

パラメータの疑問符プレースホルダの位置と、 SqlCeParameter オブジェクトを SqlCeParameterCollection に追加する順序とを、正しく対応させる必要があります。

また、SQL Server CE のデータ プロバイダでは、バッチ クエリをサポートしていません。コマンドは Select * from Customers という形式に従う必要があります。 Select * from Customers; Select * from Orders; は使用できません。System.Data.SqlClient 用に生成されたコードを使用する場合は、必要に応じて、この制約に準拠するようにクエリを変更します。

SQL Server CE は一度に 1 つの接続しかサポートしていませんが、複数のコマンドで 1 つの接続を共有できます。したがって、同じ接続で SqlCeDataReader の複数のインスタンスを使用できます。この動作は System.Data.SqlClient の動作とは異なります。

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

必要条件

名前空間: System.Data.SqlServerCe

プラットフォーム: .NET Compact Framework - Windows CE .NET

アセンブリ: System.Data.Sqlserverce (System.Data.Sqlserverce.dll 内)

参照

SqlCeCommand メンバ | System.Data.SqlServerCe 名前空間 | SqlCeDataAdapter | SqlCeConnection