IDataParameterCollection

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

IDataParameterCollection インターフェイス

Command オブジェクトに関連するすべてのパラメータと、それらのパラメータの DataSet 列へのマップを収集します。データ ソースにアクセスする .NET Framework データ プロバイダによって実装されます。

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

Visual Basic (宣言)

Public Interface IDataParameterCollection
    Inherits IList, ICollection, IEnumerable

Visual Basic (使用法)

Dim instance As IDataParameterCollection

C#

public interface IDataParameterCollection : IList, ICollection,
 IEnumerable

C++

public interface class IDataParameterCollection
 : IList, ICollection, IEnumerable

J#

public interface IDataParameterCollection extends IList, ICollection,
 
    IEnumerable

JScript

public interface IDataParameterCollection extends
 IList, ICollection, 
    IEnumerable

解説

IDataParameterCollection インターフェイスによって、継承クラスは Parameter コレクションを実装できます。Parameter クラスの詳細については、「コマンドによるストアド プロシージャの使用」を参照してください。.NET Framework データ プロバイダの実装の詳細については、「Implementing a .NET Framework Data Provider」を参照してください。

アプリケーションでは IDataParameterCollection インターフェイスのインスタンスは直接作成されず、IDataParameterCollection を継承するクラスのインスタンスが作成されます。

IDataParameterCollection を継承するクラスは、継承されたメンバを実装する必要があり、通常、プロバイダ固有の機能を追加する追加メンバを定義する必要があります。たとえば、IDataParameterCollection インターフェイスが RemoveAt メソッドの 1 つの実装を定義します。次に、OleDbParameterCollection クラスがこのメソッドを継承し、RemoveAt の 2 つの追加オーバーロードを定義します。

実装時の注意 IDataParameterCollection インターフェイスから継承する場合は、次のコンストラクタを実装する必要があります。

項目	説明
PrvParameterCollection()	空の PrvParameterCollection クラスを作成します。

使用例

SqlDataAdapter 内の SqlParameterCollection コレクションを使用して、派生クラス SqlParameter の複数のインスタンスを作成する例を次に示します。これらのパラメータは、データ ソースからのデータの選択と、DataSet でのデータの配置に使用されます。この例は、DataSet および SqlDataAdapter が、正しいスキーマ、コマンド、および接続で既に作成されていることを前提にしています。

Visual Basic

Public Sub AddSqlParameters()
    ' ...
    ' create categoriesDataSet and categoriesAdapter
    ' ...
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@CategoryName", SqlDbType.VarChar, 80).Value
 = "toasters"
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@SerialNum", SqlDbType.Int).Value = 239
    
    categoriesAdapter.Fill(categoriesDataSet)
End Sub  

C#

public void AddSqlParameters() 
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...

  categoriesAdapter.SelectCommand.Parameters.Add(
    "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
  categoriesAdapter.SelectCommand.Parameters.Add(
    "@SerialNum", SqlDbType.Int).Value = 239;
  categoriesAdapter.Fill(categoriesDataSet);

}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

バージョン情報

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

参照

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

IDataParameterCollection プロパティ

パブリック プロパティ

	名前	説明
	Item	指定したインデックス位置にあるパラメータを取得します。

参照

関連項目

IDataParameterCollection インターフェイス
System.Data 名前空間

IDataParameterCollection メソッド

パブリック メソッド

	名前	説明
	Contains	コレクション内のパラメータに指定したソース テーブル名が含まれているかどうかを示す値を取得します。
	IndexOf	コレクション内の IDataParameter の位置を取得します。
	RemoveAt	IDataParameter をコレクションから削除します。

参照

関連項目

IDataParameterCollection インターフェイス
System.Data 名前空間

IDataParameterCollection メンバ

Command オブジェクトに関連するすべてのパラメータと、それらのパラメータの DataSet 列へのマップを収集します。データ ソースにアクセスする .NET Framework データ プロバイダによって実装されます。

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

パブリック プロパティ

	名前	説明
	Item	指定したインデックス位置にあるパラメータを取得します。

パブリック メソッド

	名前	説明
	Contains	コレクション内のパラメータに指定したソース テーブル名が含まれているかどうかを示す値を取得します。
	IndexOf	コレクション内の IDataParameter の位置を取得します。
	RemoveAt	IDataParameter をコレクションから削除します。

参照

関連項目

IDataParameterCollection インターフェイス
System.Data 名前空間