IDbDataAdapter インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
DataSetを満たし、データ ソースを更新するために使用され、リレーショナル データベースにアクセスする.NET データ プロバイダーによって実装される、コマンド関連のプロパティのセットを表します。
public interface class IDbDataAdapter : System::Data::IDataAdapter
public interface IDbDataAdapter : System.Data.IDataAdapter
type IDbDataAdapter = interface
interface IDataAdapter
Public Interface IDbDataAdapter
Implements IDataAdapter
- 派生
- 実装
例
次の例では、派生クラス ( SqlCommand、 SqlDataAdapter 、および 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
注釈
IDbDataAdapter インターフェイスは、IDataAdapter インターフェイスから継承し、リレーショナル データベースで使用するように設計された DataAdapter をオブジェクトが作成できるようにします。 IDbDataAdapter インターフェイスと、必要に応じてユーティリティ クラス DbDataAdapterを使用すると、継承クラスで DataAdapter クラスを実装できます。これは、データ ソースとDataSetの間のブリッジを表します。 DataAdapter クラスの詳細については、「 DataAdapter からの DataSet の設定」を参照してください。
アプリケーションは、 IDbDataAdapter インターフェイスのインスタンスを直接作成するのではなく、 IDbDataAdapter と DbDataAdapterを継承するクラスのインスタンスを作成します。
IDbDataAdapterを継承するクラスは、継承されたメンバーを実装し、通常はプロバイダー固有の機能を追加するために追加のメンバーを定義する必要があります。 たとえば、IDbDataAdapter インターフェイスは SelectCommand プロパティを定義し、DbDataAdapter インターフェイスはパラメーターとしてFillを受け取るDataTable メソッドを定義します。 さらに、 OleDbDataAdapter クラスは、 SelectCommand プロパティと Fill メソッドを継承し、ADO Recordset オブジェクトをパラメーターとして受け取る Fill メソッドの 2 つの追加オーバーロードも定義します。
注意 (実装者)
.NET Framework データ プロバイダー間の整合性を高めるために、継承クラスに Prv DataAdapter という形式で名前を付けます。ここで、Prv は、特定の .NET Framework データ プロバイダー名前空間内のすべてのクラスに与えられる統一されたプレフィックスです。 たとえば、Sqlは、SqlDataAdapter名前空間のSystem.Data.SqlClient クラスのプレフィックスです。
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 クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| DeleteCommand |
データ セットからレコードを削除するための SQL ステートメントを取得または設定します。 |
| InsertCommand |
データ ソースに新しいレコードを挿入するために使用する SQL ステートメントを取得または設定します。 |
| MissingMappingAction |
マップされていないソース テーブルまたは列をソース名と共に渡してフィルター処理するか、エラーを発生させるかを示します。値の指定も可能です。 (継承元 IDataAdapter) |
| MissingSchemaAction |
不足しているソース テーブル、列、およびそれらのリレーションシップをデータセット スキーマに追加するか、無視するか、エラーが発生するかを示します。 (継承元 IDataAdapter) |
| SelectCommand |
データ ソース内のレコードを選択するために使用する SQL ステートメントを取得または設定します。 |
| TableMappings |
ソース テーブルをデータセット テーブルにマップする方法を示すコレクションを取得します。 (継承元 IDataAdapter) |
| UpdateCommand |
データ ソース内のレコードを更新するために使用する SQL ステートメントを取得または設定します。 |
メソッド
| 名前 | 説明 |
|---|---|
| Fill(DataSet) |
DataSet名を使用してデータ ソース内の行と一致するようにDataSetの行を追加または更新し、"Table" という名前のDataTableを作成します。 (継承元 IDataAdapter) |
| FillSchema(DataSet, SchemaType) |
指定したDataTableに "Table" という名前のDataSetを追加し、指定したSchemaTypeに基づいてデータ ソース内のスキーマと一致するようにスキーマを構成します。 (継承元 IDataAdapter) |
| GetFillParameters() |
SQL SELECT ステートメントの実行時にユーザーが設定したパラメーターを取得します。 (継承元 IDataAdapter) |
| Update(DataSet) |
"Table" という名前のDataSetから、指定したDataTableに挿入、更新、または削除された行ごとに、それぞれの INSERT、UPDATE、または DELETE ステートメントを呼び出します。 (継承元 IDataAdapter) |