IDataAdapter

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

IDataAdapter インターフェイス

オブジェクトが DataAdapter を実装できるようにします。DataSet の格納と更新およびデータ ソースの更新に使用するメソッドとマップ アクション関連プロパティのセットを表します。

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

Visual Basic (宣言)

Public Interface IDataAdapter

Visual Basic (使用法)

Dim instance As IDataAdapter

C#

public interface IDataAdapter

C++

public interface class IDataAdapter

J#

public interface IDataAdapter

JScript

public interface IDataAdapter

解説

IDataAdapter インターフェイスによって、継承クラスはデータ ソースと DataSet 間のブリッジを表す DataAdapter クラスを実装できます。DataAdapter クラスの詳細については、「DataAdapter からの DataSet の読み込み」を参照してください。.NET Framework データ プロバイダの実装の詳細については、「Implementing a .NET Framework Data Provider」を参照してください。

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

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

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

項目	説明
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

C#

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;
    }
}

プラットフォーム

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

参照

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

IDataAdapter プロパティ

パブリック プロパティ

	名前	説明
	TableMappings	ソース テーブルをデータ セット テーブルに割り当てる方法を示します。

参照

関連項目

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

IDataAdapter メソッド

パブリック メソッド

	名前	説明
	Fill	DataSet 名を使用して、データ ソース内の行と一致するように、DataSet 内の行を追加または更新します。また、Table という名前の DataTable を作成します。
	FillSchema	指定された DataSet に Table という名前の DataTable を追加し、指定された SchemaType に基づいて、データ ソース内のスキーマと一致するようにスキーマを設定します。
	GetFillParameters	SQL SELECT ステートメントの実行時にユーザーが設定したパラメータを取得します。
	Update	指定された DataSet 内の Table という名前の DataTable に含まれる挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。

参照

関連項目

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

IDataAdapter メンバ

オブジェクトが DataAdapter を実装できるようにします。DataSet の格納と更新およびデータ ソースの更新に使用するメソッドとマップ アクション関連プロパティのセットを表します。

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

パブリック プロパティ

	名前	説明
	TableMappings	ソース テーブルをデータ セット テーブルに割り当てる方法を示します。

パブリック メソッド

	名前	説明
	Fill	DataSet 名を使用して、データ ソース内の行と一致するように、DataSet 内の行を追加または更新します。また、Table という名前の DataTable を作成します。
	FillSchema	指定された DataSet に Table という名前の DataTable を追加し、指定された SchemaType に基づいて、データ ソース内のスキーマと一致するようにスキーマを設定します。
	GetFillParameters	SQL SELECT ステートメントの実行時にユーザーが設定したパラメータを取得します。
	Update	指定された DataSet 内の Table という名前の DataTable に含まれる挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。

参照

関連項目

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