OleDbParameterCollection

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

OleDbParameterCollection クラス

OleDbCommand に関連するパラメータ コレクション、および DataSet 列に対する各パラメータのマップを表します。

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

Visual Basic (宣言)

Public NotInheritable Class
 OleDbParameterCollection
    Inherits DbParameterCollection

Visual Basic (使用法)

Dim instance As OleDbParameterCollection

C#

public sealed class OleDbParameterCollection
 : DbParameterCollection

C++

public ref class OleDbParameterCollection sealed
 : public DbParameterCollection

J#

public final class OleDbParameterCollection
 extends DbParameterCollection

JScript

public final class OleDbParameterCollection
 extends DbParameterCollection

解説

コレクション内のパラメータ数は、コマンド テキスト内のパラメータ プレースホルダの数と同じにする必要があります。これらが一致しないと、.NET Framework OLE DB 用データ プロバイダは、エラーを発生させることがあります。

使用例

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

Visual Basic

Public Function GetDataSetFromAdapter( _
    ByVal dataSet As DataSet, ByVal
 connectionString As String, _
    ByVal queryString As String)
 As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New
 OleDbDataAdapter(queryString, connection)

        ' Set the parameters.
        adapter.SelectCommand.Parameters.Add( _
            "@CategoryName", OleDbType.VarChar, 80).Value
 = "toasters"
        adapter.SelectCommand.Parameters.Add( _
         "@SerialNum", OleDbType.Integer).Value =
 239

        ' Open the connection and fill the DataSet.
        Try
            connection.Open()
            adapter.Fill(dataSet)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using

    Return dataSet
End Function

C#

public DataSet GetDataSetFromAdapter(
    DataSet dataSet, string connectionString, string
 queryString)
{
    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter =
            new OleDbDataAdapter(queryString, connection);

        // Set the parameters.
        adapter.SelectCommand.Parameters.Add(
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters";
        adapter.SelectCommand.Parameters.Add(
            "@SerialNum", OleDbType.Integer).Value = 239;

        // Open the connection and fill the DataSet.
        try
        {
            connection.Open();
            adapter.Fill(dataSet);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
    return dataSet;
}

C#

using System;
using System.Data;
using System.Data.OleDb;

class Class1
{
    static void Main()
    {
        //        string x = "Provider=SQLOLEDB;Data Source=(local);Integrated
 Security=SSPI;Initial Catalog=Northwind";
    }

    public DataSet GetDataSetFromAdapter(
        DataSet dataSet, string connectionString, string
 queryString)
    {
        using (OleDbConnection connection =
                   new OleDbConnection(connectionString))
        {
            OleDbDataAdapter adapter =
                new OleDbDataAdapter(queryString, connection);

            // Set the parameters.
            adapter.SelectCommand.Parameters.Add(
                "@CategoryName", OleDbType.VarChar, 80).Value = "toasters";
            adapter.SelectCommand.Parameters.Add(
                "@SerialNum", OleDbType.Integer).Value = 239;

            // Open the connection and fill the DataSet.
            try
            {
                connection.Open();
                adapter.Fill(dataSet);
            }
            catch (Exception ex)
            {
                Console.WriteLine(ex.Message);
            }
            // The connection is automatically closed when the
            // code exits the using block.
        }
        return dataSet;
    }

継承階層

System.Object
   System.MarshalByRefObject
     System.Data.Common.DbParameterCollection
      System.Data.OleDb.OleDbParameterCollection

スレッド セーフ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
OleDbParameterCollection メンバ
System.Data.OleDb 名前空間
その他の技術情報
コマンドの使用
DataAdapter によるパラメータの使用

OleDbParameterCollection プロパティ

パブリック プロパティ

	名前	説明
	Count	オーバーライドされます。 OleDbParameterCollection の要素数を格納している整数を返します。読み取り専用。
	IsFixedSize	オーバーライドされます。 OleDbParameterCollection が固定サイズかどうかを示す値を取得します。読み取り専用。
	IsReadOnly	オーバーライドされます。 OleDbParameterCollection が読み取り専用かどうかを示す値を取得します。
	IsSynchronized	オーバーライドされます。 OleDbParameterCollection の同期がとられているかどうかを示す値を取得します。読み取り専用。
	Item	オーバーロードされます。 指定した属性を持つ OleDbParameter を取得または設定します。
	SyncRoot	オーバーライドされます。 OleDbParameterCollection へのアクセスを同期するために使用できるオブジェクトを取得します。読み取り専用。

参照

関連項目

OleDbParameterCollection クラス
System.Data.OleDb 名前空間

その他の技術情報

コマンドの使用
DataAdapter によるパラメータの使用

OleDbParameterCollection メソッド

パブリック メソッド

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

	名前	説明
	Add	オーバーロードされます。 オーバーライドされます。 OleDbParameter を OleDbParameterCollection に追加します。
	AddRange	オーバーロードされます。 オーバーライドされます。 OleDbParameterCollection の末尾に要素を追加します。
	AddWithValue	値を OleDbParameterCollection の末尾に追加します。
	Clear	オーバーライドされます。 OleDbParameterCollection からすべての OleDbParameter オブジェクトを削除します。
	Contains	オーバーロードされます。 オーバーライドされます。 指定したオブジェクトがこの OleDbParameterCollection 内にあるかどうかを確認します。
	CopyTo	オーバーロードされます。 オーバーライドされます。 指定したオブジェクトに現在の OleDbParameterCollection のすべての要素をコピーします。
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetEnumerator	オーバーライドされます。 OleDbParameterCollection を反復処理する列挙子を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IndexOf	オーバーロードされます。 オーバーライドされます。 指定した OleDbParameterCollection のコレクション内での位置を取得します。
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	Insert	オーバーロードされます。 オーバーライドされます。 OleDbParameter オブジェクトを OleDbParameterCollection に挿入します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	オーバーロードされます。 オーバーライドされます。 OleDbParameterCollection から OleDbParameter オブジェクトを削除します。
	RemoveAt	オーバーロードされます。 オーバーライドされます。 OleDbParameterCollection の指定したインデックス位置から OleDbParameter オブジェクトを削除します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

参照

関連項目

OleDbParameterCollection クラス
System.Data.OleDb 名前空間

その他の技術情報

コマンドの使用
DataAdapter によるパラメータの使用

OleDbParameterCollection メンバ

OleDbCommand に関連するパラメータ コレクション、および DataSet 列に対する各パラメータのマップを表します。

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

パブリック プロパティ

	名前	説明
	Count	オーバーライドされます。 OleDbParameterCollection の要素数を格納している整数を返します。読み取り専用。
	IsFixedSize	オーバーライドされます。 OleDbParameterCollection が固定サイズかどうかを示す値を取得します。読み取り専用。
	IsReadOnly	オーバーライドされます。 OleDbParameterCollection が読み取り専用かどうかを示す値を取得します。
	IsSynchronized	オーバーライドされます。 OleDbParameterCollection の同期がとられているかどうかを示す値を取得します。読み取り専用。
	Item	オーバーロードされます。 指定した属性を持つ OleDbParameter を取得または設定します。
	SyncRoot	オーバーライドされます。 OleDbParameterCollection へのアクセスを同期するために使用できるオブジェクトを取得します。読み取り専用。

パブリック メソッド

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

	名前	説明
	Add	オーバーロードされます。 オーバーライドされます。 OleDbParameter を OleDbParameterCollection に追加します。
	AddRange	オーバーロードされます。 オーバーライドされます。 OleDbParameterCollection の末尾に要素を追加します。
	AddWithValue	値を OleDbParameterCollection の末尾に追加します。
	Clear	オーバーライドされます。 OleDbParameterCollection からすべての OleDbParameter オブジェクトを削除します。
	Contains	オーバーロードされます。 オーバーライドされます。 指定したオブジェクトがこの OleDbParameterCollection 内にあるかどうかを確認します。
	CopyTo	オーバーロードされます。 オーバーライドされます。 指定したオブジェクトに現在の OleDbParameterCollection のすべての要素をコピーします。
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetEnumerator	オーバーライドされます。 OleDbParameterCollection を反復処理する列挙子を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IndexOf	オーバーロードされます。 オーバーライドされます。 指定した OleDbParameterCollection のコレクション内での位置を取得します。
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	Insert	オーバーロードされます。 オーバーライドされます。 OleDbParameter オブジェクトを OleDbParameterCollection に挿入します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	オーバーロードされます。 オーバーライドされます。 OleDbParameterCollection から OleDbParameter オブジェクトを削除します。
	RemoveAt	オーバーロードされます。 オーバーライドされます。 OleDbParameterCollection の指定したインデックス位置から OleDbParameter オブジェクトを削除します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

参照

関連項目

OleDbParameterCollection クラス
System.Data.OleDb 名前空間

その他の技術情報

コマンドの使用
DataAdapter によるパラメータの使用