SqlCeParameterCollectionとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

SqlCeParameterCollection クラス

SqlCeCommand に関連するすべてのパラメータ、および DataSet 列に対する各パラメータのマップを収集します。

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

Visual Basic (宣言)

Public NotInheritable Class
 SqlCeParameterCollection
    Inherits DbParameterCollection

Visual Basic (使用法)

Dim instance As SqlCeParameterCollection

public sealed class SqlCeParameterCollection
 : DbParameterCollection

C++

public ref class SqlCeParameterCollection sealed
 : public DbParameterCollection

public final class SqlCeParameterCollection
 extends DbParameterCollection

JScript

public final class SqlCeParameterCollection
 extends DbParameterCollection

解説

コレクション内のパラメータ数は、コマンドテキスト内のパラメータプレースホルダの数と同じにする必要があります。これらが異なると、.NET Compact Framework Data Provider for SQL Server Mobile がエラーを発生させる可能性があります。

使用例

SqlCeDataAdapter の SqlCeParameterCollection コレクションを使用して、SqlCeParameter の複数のインスタンスを作成する例を次に示します。これらのパラメータは、データソース内のデータ選択に使用されます。その後で、このデータが DataSet に格納されます。この例は、DataSet および SqlCeDataAdapter が、正しいスキーマ、コマンド、および接続で既に作成されていることを前提にしています。

Visual Basic

Dim cmd As SqlCeCommand = Nothing
Dim adp As SqlCeDataAdapter = Nothing

Try
    adp = New SqlCeDataAdapter()
    Dim conn As New SqlCeConnection("Data
 Source = MyDatabase.sdf")

    ' Create the SelectCommand
    '
    cmd = conn.CreateCommand()
    cmd.CommandText = "SELECT * FROM Orders WHERE [Ship Country]
 = @country AND [Ship City] = @city"
    cmd.Parameters.Add("@country", SqlDbType.NVarChar,
 15)
    cmd.Parameters.Add("@city", SqlDbType.NVarChar,
 15)

    cmd.Parameters("@country").Value = "UK"
    cmd.Parameters("@city").Value = "London"

    adp.SelectCommand = cmd

    ' Create the DeleteCommand
    '
    cmd = conn.CreateCommand()
    cmd.CommandText = "DELETE FROM Orders WHERE [Order ID] = @orderID"

    Dim p As SqlCeParameter = cmd.Parameters.Add("@orderID",
 SqlDbType.NChar, 5, "Order ID")
    p.SourceVersion = DataRowVersion.Original

    adp.DeleteCommand = cmd

    ' Populate the dataset with the results from the SELECT statement
    '
    Dim ds As New DataSet()
    adp.Fill(ds)

    ' Modify the dataset
    '
    MessageBox.Show("Number of rows: " & ds.Tables(0).Rows.Count)

    ' Delete some rows
    '
    ds.Tables(0).Rows(3).Delete()
    ds.Tables(0).Rows(4).Delete()

    ' This will execute two DELETE statements 
    '
    adp.Update(ds.Tables(0))
Catch e As Exception
    MessageBox.Show(e.Message)
Finally
    If Not Nothing Is
 adp.SelectCommand Then
        adp.SelectCommand.Dispose()
    End If
    If Not Nothing Is
 adp.DeleteCommand Then
        adp.DeleteCommand.Dispose()
    End If
End Try

SqlCeCommand cmd = null;
SqlCeDataAdapter adp = null;

try
{
    adp = new SqlCeDataAdapter();
    SqlCeConnection conn = new SqlCeConnection("Data Source
 = MyDatabase.sdf");

    // Create the SelectCommand
    //
    cmd = conn.CreateCommand();
    cmd.CommandText = "SELECT * FROM Orders WHERE [Ship Country] = @country
 AND [Ship City] = @city";
    cmd.Parameters.Add("@country", SqlDbType.NVarChar, 15);
    cmd.Parameters.Add("@city", SqlDbType.NVarChar, 15);

    cmd.Parameters["@country"].Value = "UK";
    cmd.Parameters["@city"].Value = "London";

    adp.SelectCommand = cmd;

    // Create the DeleteCommand
    //
    cmd = conn.CreateCommand();
    cmd.CommandText = "DELETE FROM Orders WHERE [Order ID] = @orderID";

    SqlCeParameter p = cmd.Parameters.Add("@orderID", SqlDbType.NChar,
 5, "Order ID");
    p.SourceVersion = DataRowVersion.Original;

    adp.DeleteCommand = cmd;

    // Populate the dataset with the results from the SELECT statement
    //
    DataSet ds = new DataSet();
    adp.Fill(ds);

    // Modify the dataset
    //
    MessageBox.Show("Number of rows: " + ds.Tables[0].Rows.Count);

    // Delete some rows
    //
    ds.Tables[0].Rows[3].Delete();
    ds.Tables[0].Rows[4].Delete();

    // This will execute two DELETE statements 
    //
    adp.Update(ds.Tables[0]);
}
catch (Exception e)
{
    MessageBox.Show(e.Message);
}
finally
{
    if (null != adp.SelectCommand) adp.SelectCommand.Dispose();
    if (null != adp.DeleteCommand) adp.DeleteCommand.Dispose();
}

継承階層

System.Object
   System.MarshalByRefObject
     System.Data.Common.DbParameterCollection
      System.Data.SqlServerCe.SqlCeParameterCollection

スレッドセーフ

この型の 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

参照

関連項目
SqlCeParameterCollection メンバ
System.Data.SqlServerCe 名前空間

SqlCeParameterCollection プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	Count	オーバーライドされます。コレクション内の SqlCeParameter オブジェクト数を取得します。
	IsFixedSize	オーバーライドされます。
	IsReadOnly	オーバーライドされます。
	IsSynchronized	オーバーライドされます。
	Item	オーバーロードされます。指定した属性を持つ SqlCeParameter を取得または設定します。
	SyncRoot	オーバーライドされます。

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

	名前	説明
	System.Data.IDataParameterCollection.Item

参照

SqlCeParameterCollection メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Add	オーバーロードされます。オーバーライドされます。 SqlCeParameter を SqlCeCommand に追加します。
	AddRange	オーバーライドされます。
	Clear	オーバーライドされます。コレクションからすべての項目を削除します。
	Contains	オーバーロードされます。オーバーライドされます。特定の SqlCeParameter がコレクション内に存在するかどうかを示します。
	CopyTo	オーバーライドされます。 SqlCeParameterCollection から、指定した配列に SqlCeParameter オブジェクトをコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetEnumerator	オーバーライドされます。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IndexOf	オーバーロードされます。オーバーライドされます。 SqlCeParameter の、コレクション内での位置を取得します。
	Insert	オーバーライドされます。コレクション内の指定したインデックス位置に SqlCeParameter を挿入します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	オーバーライドされます。指定した SqlCeParameter をコレクションから削除します。
	RemoveAt	オーバーロードされます。オーバーライドされます。指定した SqlCeParameter をコレクションから削除します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetParameter	オーバーロードされます。指定したプロパティ値の DbParameter を取得します。 ( DbParameterCollection から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	SetParameter	オーバーロードされます。指定したパラメータを指定した値に設定します。 ( DbParameterCollection から継承されます。)

参照

SqlCeParameterCollection メンバ

SqlCeCommand に関連するすべてのパラメータ、および DataSet 列に対する各パラメータのマップを収集します。

SqlCeParameterCollection データ型で公開されるメンバを以下の表に示します。

パブリックプロパティ

	名前	説明
	Count	オーバーライドされます。コレクション内の SqlCeParameter オブジェクト数を取得します。
	IsFixedSize	オーバーライドされます。
	IsReadOnly	オーバーライドされます。
	IsSynchronized	オーバーライドされます。
	Item	オーバーロードされます。指定した属性を持つ SqlCeParameter を取得または設定します。
	SyncRoot	オーバーライドされます。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Add	オーバーロードされます。オーバーライドされます。 SqlCeParameter を SqlCeCommand に追加します。
	AddRange	オーバーライドされます。
	Clear	オーバーライドされます。コレクションからすべての項目を削除します。
	Contains	オーバーロードされます。オーバーライドされます。特定の SqlCeParameter がコレクション内に存在するかどうかを示します。
	CopyTo	オーバーライドされます。 SqlCeParameterCollection から、指定した配列に SqlCeParameter オブジェクトをコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetEnumerator	オーバーライドされます。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IndexOf	オーバーロードされます。オーバーライドされます。 SqlCeParameter の、コレクション内での位置を取得します。
	Insert	オーバーライドされます。コレクション内の指定したインデックス位置に SqlCeParameter を挿入します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	オーバーライドされます。指定した SqlCeParameter をコレクションから削除します。
	RemoveAt	オーバーロードされます。オーバーライドされます。指定した SqlCeParameter をコレクションから削除します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetParameter	オーバーロードされます。指定したプロパティ値の DbParameter を取得します。 (DbParameterCollection から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	SetParameter	オーバーロードされます。指定したパラメータを指定した値に設定します。 (DbParameterCollection から継承されます。)