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

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

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

IDbDataAdapter インターフェイス

DataSet にデータを格納し、データソースを更新するために使用するコマンド関連プロパティのセットを表します。リレーショナルデータベースにアクセスする .NET Framework データプロバイダによって実装されます。

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

Visual Basic (宣言)

Public Interface IDbDataAdapter
    Inherits IDataAdapter

Visual Basic (使用法)

Dim instance As IDbDataAdapter

public interface IDbDataAdapter : IDataAdapter

C++

public interface class IDbDataAdapter : IDataAdapter

public interface IDbDataAdapter extends IDataAdapter

JScript

public interface IDbDataAdapter extends IDataAdapter

解説

IDbDataAdapter インターフェイスは IDataAdapter インターフェイスから継承し、オブジェクトがリレーショナルデータベース用の DataAdapter を作成できるようにします。IDbDataAdapter インターフェイス、およびオプションで DbDataAdapter ユーティリティクラスによって、継承クラスはデータソースと DataSet 間のブリッジを表す DataAdapter クラスを実装できます。DataAdapter クラスの詳細については、「DataAdapter からの DataSet の読み込み」を参照してください。.NET Framework データプロバイダの実装の詳細については、「Implementing a .NET Framework Data Provider」を参照してください。

アプリケーションでは、IDbDataAdapter インターフェイスのインスタンスを直接作成せずに、IDbDataAdapter および DbDataAdapter を継承するクラスのインスタンスを作成します。

IDbDataAdapter を継承するクラスは、継承されたメンバを実装する必要があり、通常、プロバイダ固有の機能を追加する追加メンバを定義する必要があります。たとえば、IDbDataAdapter インターフェイスが SelectCommand プロパティを定義し、DbDataAdapter インターフェイスが DataTable をパラメータとしてとる Fill メソッドを定義します。次に、OleDbDataAdapter クラスが SelectCommand プロパティと Fill メソッドを継承し、ADO Recordset オブジェクトをパラメータとしてとる Fill メソッドの 2 つの追加オーバーロードも定義します。

実装時の注意 .NET Framework データプロバイダ間に一貫性を持たせるために、継承クラスには Prv DataAdapter という形式の名前を付けてください。Prv は各 .NET Framework データプロバイダの名前空間内のすべてのクラスに付けられる統一的なプリフィックスです。たとえば、Sql は System.Data.SqlClient 名前空間内の SqlDataAdapter クラスのプリフィックスです。 IDbDataAdapter インターフェイスから継承する場合は、次のコンストラクタを実装する必要があります。

項目	説明
PrvDataAdapter()	PrvDataAdapter クラスの新しいインスタンスを初期化します。
PrvDataAdapter(PrvCommand selectCommand)	指定した SQL SELECT ステートメントを使用して、PrvDataAdapter クラスの新しいインスタンスを初期化します。
PrvDataAdapter(string selectCommandText, string selectConnectionString)	SQL SELECT ステートメントと接続文字列を使用して、PrvDataAdapter クラスの新しいインスタンスを初期化します。
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection)	SQL SELECT ステートメントと PrvConnection オブジェクトを使用して、PrvDataAdapter クラスの新しいインスタンスを初期化します。

使用例

派生クラス SqlCommand、SqlDataAdapter、および SqlConnection を使用して、データソースからレコードを選択する例を次に示します。次に、格納された DataSet が返されます。そのために、初期化された DataSet、接続文字列、および Transact-SQL SELECT ステートメントのクエリ文字列がメソッドに渡されます。

Visual Basic

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

    Using connection As New SqlConnection(connectionString)
        Dim adapter As New
 SqlDataAdapter()
        adapter.SelectCommand = New SqlCommand( _
            queryString, connection)
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function

private static DataSet SelectRows(DataSet dataset
,
    string connectionString,string queryString)
 
{
    using (SqlConnection connection = 
        new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter();
        adapter.SelectCommand = new SqlCommand(
            queryString, connection);
        adapter.Fill(dataset);
        return dataset;
    }
}