IDataAdapter インターフェイス

  • リファレンス

定義

名前空間:
System.Data
アセンブリ:
System.Data.Common.dll
アセンブリ:
System.Data.dll
アセンブリ:
netstandard.dll

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

IDbDataAdapter インスタンスは、テキスト コマンド (例: Transact-SQL) を入力するリレーショナル データベースのデータ ソース (またはそれに類似したもの) で、IDataAdapter インスタンスは任意の型のデータ ソースに使用できます。

public interface class IDataAdapter
public interface IDataAdapter
type IDataAdapter = interface
Public Interface IDataAdapter
派生

例

次の例では、派生クラス 、、SqlCommandSqlDataAdapter、および SqlConnectionを使用して、データベースからレコードを選択します。 塗りつぶ DataSet された が返されます。 これを行うために、メソッドには、初期化 DataSetされた 、接続文字列、および Transact-SQL SELECT ステートメントであるクエリ文字列が渡されます。

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

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

注釈

IDataAdapterインターフェイスを使用すると、継承クラスで DataAdapter クラスを実装できます。これは、データ ソースと の間のブリッジをDataSet表します。 DataAdapter クラスの詳細については、「 DataAdapter からの DataSet の設定」を参照してください。

アプリケーションは インターフェイスの IDataAdapter インスタンスを直接作成するのではなく、 を継承するクラスのインスタンスを実装します IDataAdapter。

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

注意 (実装者)

.NET Frameworkデータ プロバイダー間の一貫性を高めるために、継承クラスに DataAdapter という形式Prvで名前を付けます。ここでPrv、 は、特定の.NET Framework データ プロバイダー名前空間内のすべてのクラスに与えられる均一プレフィックスです。 たとえば、 Sql は 名前空間の SqlDataAdapterSystem.Data.SqlClient クラスのプレフィックスです。

インターフェイスから 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 クラスの新しいインスタンスを初期化します。

プロパティ

MissingMappingAction

割り当てられていないソース テーブルまたはソース列をソース名で渡して、フィルター処理するか、エラーを発生させるかどうかを指示または指定します。
MissingSchemaAction

存在しないソース テーブル、ソース列、それらのリレーションシップをデータセット スキーマに追加するか、無視するか、またはエラーを発生させるかを表示または指定します。
TableMappings

ソース テーブルをデータセット テーブルにマップする方法を示すコレクションを取得します。

メソッド

Fill(DataSet)

DataSet 名を使用して、データ ソース内の行と一致するように、DataSet 内の行を追加または更新します。また、Table という名前の DataTable を作成します。
FillSchema(DataSet, SchemaType)

"Table" という名前の DataTable を指定された DataSet に追加し、指定された SchemaType に基づいて、データ ソースにあるスキーマと一致するようにスキーマを構成します。
GetFillParameters()

SQL SELECT ステートメントの実行時にユーザーが設定したパラメーターを取得します。
Update(DataSet)

指定された DataSet 内の Table という名前の DataTable に含まれる挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。

適用対象