次の方法で共有


OleDbDataAdapter クラス

定義

DataSet へのデータの格納およびデータ ソースの更新に使用される、一連のデータ コマンドおよびデータベース接続を表します。

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter
type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable
type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter
Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
継承
実装

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

public static OleDbDataAdapter CreateDataAdapter(string selectCommand,
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter(selectCommand, connection);

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the Insert, Update and Delete commands.
    adapter.InsertCommand = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)");

    adapter.UpdateCommand = new OleDbCommand(
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?");

    adapter.DeleteCommand = new OleDbCommand(
        "DELETE FROM Customers WHERE CustomerID = ?");

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}
Public Function CreateDataAdapter(ByVal selectCommand As String, _
    ByVal connection As OleDbConnection) As OleDbDataAdapter

    Dim adapter As OleDbDataAdapter = _
        New OleDbDataAdapter(selectCommand, connection)

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey

    ' Create the commands.
    adapter.InsertCommand = New OleDbCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
         "VALUES (?, ?)")

    adapter.UpdateCommand = New OleDbCommand( _
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?")

    adapter.DeleteCommand = New OleDbCommand( _
        "DELETE FROM Customers WHERE CustomerID = ?")

    ' Create the parameters.
    adapter.InsertCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.InsertCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.UpdateCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.UpdateCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")
    adapter.UpdateCommand.Parameters.Add( _
        "@oldCustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    adapter.DeleteCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    Return adapter
End Function

注釈

OleDbDataAdapter 、データを取得および保存するための データ ソースと データ ソースの間 DataSet のブリッジとして機能します。 はOleDbDataAdapter、 を使用Fillしてデータ ソースから にDataSetUpdateデータを読み込み、 で行われたDataSet変更をデータ ソースに送信することで、このブリッジを提供します。

OleDbDataAdapterDataSet塗りつぶすと、返されたデータの適切なテーブルと列が作成されます (まだ存在しない場合)。 ただし、 プロパティが に設定されていない限り MissingSchemaAction 、主キー情報は暗黙的に作成されたスキーマに AddWithKey含まれません。 また、 を使用FillSchemaしてデータをOleDbDataAdapter入力する前にDataSet、主キー情報を含む のスキーマを作成することもできます。 詳細については、「 DataSet への既存の制約の追加」を参照してください。

MSDataShape プロバイダーを含む一部の OLE DB プロバイダーでは、ベース テーブルまたは主キー情報が返されないことに注意してください。 したがって、 はOleDbDataAdapter、作成DataTableされた に対して プロパティをPrimaryKey正しく設定できません。 このような場合は、 のテーブルの主キーを明示的に指定する DataSet必要があります。

OleDbDataAdapterには、、、DeleteCommandUpdateCommandおよび TableMappings の各プロパティも含SelectCommandInsertCommandまれており、データの読み込みと更新を容易にします。

OleDbDataAdapterインスタンスを作成すると、プロパティは初期値に設定されます。 これらの値の一覧については、 コンストラクターを OleDbDataAdapter 参照してください。

コンストラクター

OleDbDataAdapter()

OleDbDataAdapter クラスの新しいインスタンスを初期化します。

OleDbDataAdapter(OleDbCommand)

OleDbDataAdapter プロパティとして OleDbCommand を指定して、SelectCommand クラスの新しいインスタンスを初期化します。

OleDbDataAdapter(String, OleDbConnection)

OleDbDataAdapter を使用して、SelectCommand クラスの新しいインスタンスを初期化します。

OleDbDataAdapter(String, String)

OleDbDataAdapter を使用して、SelectCommand クラスの新しいインスタンスを初期化します。

フィールド

DefaultSourceTableName

DataAdapter オブジェクトがテーブル マップに使用する既定の名前。

(継承元 DbDataAdapter)

プロパティ

AcceptChangesDuringFill

Fill 操作中に DataTableDataRow が追加された後で、その行に対して AcceptChanges() を呼び出すかどうかを示す値を取得または設定します。

(継承元 DataAdapter)
AcceptChangesDuringUpdate

AcceptChanges()Update(DataSet) が呼び出されるかどうかを取得または設定します。

(継承元 DataAdapter)
CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。

(継承元 Component)
Container

IContainer を含む Component を取得します。

(継承元 Component)
ContinueUpdateOnError

行の更新中にエラーが発生したときに、例外を生成するかどうかを指定する値を取得または設定します。

(継承元 DataAdapter)
DeleteCommand

データ セットからレコードを削除するための SQL ステートメントまたはストアド プロシージャを取得または設定します。

DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。

(継承元 Component)
Events

Component に結び付けられているイベント ハンドラーのリストを取得します。

(継承元 Component)
FillCommandBehavior

データ アダプターにデータを読み込むコマンドの動作を取得または設定します。

(継承元 DbDataAdapter)
FillLoadOption

アダプターが LoadOption から DataTable にデータを読み込む方法を決定する DbDataReader を取得または設定します。

(継承元 DataAdapter)
InsertCommand

データ ソースに新しいレコードを挿入するために使用する SQL ステートメントまたはストアド プロシージャを取得または設定します。

MissingMappingAction

一致するテーブルまたは列が受信データに含まれていない場合に実行するアクションを決定します。

(継承元 DataAdapter)
MissingSchemaAction

既存の DataSet スキーマが受信データと一致しないときに実行するアクションを決定します。

(継承元 DataAdapter)
ReturnProviderSpecificTypes

Fill メソッドがプロバイダー固有の値、または共通の CLS 準拠の値のどちらを返すかを取得または設定します。

(継承元 DataAdapter)
SelectCommand

データ ソース内のレコードを選択するための SQL ステートメントまたはストアド プロシージャを取得または設定します。

Site

ComponentISite を取得または設定します。

(継承元 Component)
TableMappings

ソース テーブルと の間のプライマリ マッピングを提供するコレクションを DataTable取得します。

(継承元 DataAdapter)
UpdateBatchSize

バッチ処理サポートを有効にするかどうか、および、1 回のバッチで実行可能なコマンド数を指定する値を取得または設定します。

(継承元 DbDataAdapter)
UpdateCommand

データ ソースのレコードを更新するために使用する SQL ステートメントまたはストアド プロシージャを取得または設定します。

メソッド

AddToBatch(IDbCommand)

IDbCommand を現在のバッチに追加します。

(継承元 DbDataAdapter)
ClearBatch()

バッチからすべての IDbCommand オブジェクトを削除します。

(継承元 DbDataAdapter)
CloneInternals()
古い.
古い.
古い.
古い.

この DataAdapter のインスタンスのコピーを作成します。

(継承元 DataAdapter)
CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。

(継承元 MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

RowUpdatedEventArgs クラスの新しいインスタンスを初期化します。

(継承元 DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

RowUpdatingEventArgs クラスの新しいインスタンスを初期化します。

(継承元 DbDataAdapter)
CreateTableMappings()

新しい DataTableMappingCollection を作成します。

(継承元 DataAdapter)
Dispose()

Component によって使用されているすべてのリソースを解放します。

(継承元 Component)
Dispose(Boolean)

DbDataAdapter によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。

(継承元 DbDataAdapter)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
ExecuteBatch()

現在のバッチを実行します。

(継承元 DbDataAdapter)
Fill(DataSet)

DataSet 内の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataSet, Int32, Int32, String)

DataSet 名および DataSet 名を使用して、データ ソース内の行と一致するように、DataTable 内の指定した範囲の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)

DataSet 名、ソース テーブル名、コマンド文字列、およびコマンド動作を使用して、データ ソース内の列と一致するように、DataSet 内の指定した範囲の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataSet, Object, String)

指定した DataSet、ADO オブジェクト、およびソース テーブル名を使用して、ADO Recordset オブジェクトまたは Record オブジェクト内の行と一致するように、DataSet 内の行を追加または更新します。

Fill(DataSet, String)

DataSet 名および DataSet 名を使用して、データ ソース内の列と一致するように DataTable 内の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataSet, String, IDataReader, Int32, Int32)

DataSetDataTableIDataReader の名前を使用して、データ ソース内の行と一致するように、DataSet 内の指定した範囲の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataTable)

DataSet 名を使用して、データ ソース内の行と一致するように、DataTable 内の指定した範囲の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataTable, IDataReader)

指定した DataTableIDataReader の名前を使用して、データ ソース内の行と一致するように、DataTable 内の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)

指定した DataTableDataTable、および IDbCommand を使用して、データ ソース内の行と一致するように、CommandBehavior 内の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataTable, Object)

指定した DataTable および ADO オブジェクトを使用して、ADO Recordset オブジェクトまたは Record オブジェクト内の行と一致するように、DataTable 内の行を追加または更新します。

Fill(DataTable[], IDataReader, Int32, Int32)

データ ソース内の行と一致するように、DataTable オブジェクトのコレクション内の指定した範囲の行を追加または更新します。

(継承元 DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)

DataSet 名および DataSet 名を使用して、データ ソース内の行と一致するように、DataTable 内の指定した範囲の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(Int32, Int32, DataTable[])

1 つ以上 DataTable のオブジェクトの行を追加または更新して、指定したレコードから始まり、指定した最大レコード数まで取得するデータ ソース内の行と一致させます。

(継承元 DbDataAdapter)
FillSchema(DataSet, SchemaType)

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

(継承元 DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)

指定した DataTableDataSet を追加し、指定した SchemaType に基づいて、データ ソース内のスキーマと一致するようにスキーマを設定します。

(継承元 DbDataAdapter)
FillSchema(DataSet, SchemaType, String)

指定した DataSetDataTable を追加し、指定した SchemaType および DataTable に基づいて、データ ソースにあるスキーマと一致するようにスキーマを構成します。

(継承元 DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)

DataTable を指定した DataSet に追加します。

(継承元 DataAdapter)
FillSchema(DataTable, SchemaType)

指定された SchemaType に基づいて、指定された DataTable のスキーマを構成します。

(継承元 DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)

DataTable を指定した DataSet に追加します。

(継承元 DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)

指定した DataTable、コマンド文字列、および SchemaType 値に基づいて、指定した CommandBehavior のスキーマを設定します。

(継承元 DbDataAdapter)
GetBatchedParameter(Int32, Int32)

現在のバッチのコマンドの 1 つから IDataParameter を返します。

(継承元 DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)

バッチ更新内の、個々の更新の試行に関する情報を返します。

(継承元 DbDataAdapter)
GetFillParameters()

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

(継承元 DbDataAdapter)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetLifetimeService()
古い.

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。

(継承元 Component)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
HasTableMappings()

DataTableMappingCollection が作成されているかどうかを示します。

(継承元 DataAdapter)
InitializeBatching()

DbDataAdapter のバッチ処理を初期化します。

(継承元 DbDataAdapter)
InitializeLifetimeService()
古い.

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。

(継承元 MarshalByRefObject)
OnFillError(FillErrorEventArgs)

FillError イベントを発生させます。

(継承元 DbDataAdapter)
OnRowUpdated(RowUpdatedEventArgs)

.NET データ プロバイダーの RowUpdated イベントを発生させます。

(継承元 DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)

.NET データ プロバイダーの RowUpdating イベントを発生させます。

(継承元 DbDataAdapter)
ResetFillLoadOption()

FillLoadOption を既定の状態にリセットし、Fill(DataSet)AcceptChangesDuringFill を受け入れるようにします。

(継承元 DataAdapter)
ShouldSerializeAcceptChangesDuringFill()

AcceptChangesDuringFill プロパティを永続化する必要があるかどうかを判断します。

(継承元 DataAdapter)
ShouldSerializeFillLoadOption()

FillLoadOption プロパティを永続化する必要があるかどうかを判断します。

(継承元 DataAdapter)
ShouldSerializeTableMappings()

1 つ以上の DataTableMapping オブジェクトが存在し、それらを永続化する必要があるかどうかを確認します。

(継承元 DataAdapter)
TerminateBatching()

DbDataAdapter のバッチ処理を終了します。

(継承元 DbDataAdapter)
ToString()

Component の名前 (存在する場合) を格納する String を返します。 このメソッドはオーバーライドできません。

(継承元 Component)
Update(DataRow[])

指定した DataSet 内の配列での挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。

(継承元 DbDataAdapter)
Update(DataRow[], DataTableMapping)

指定した DataRow オブジェクトの配列内の挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。

(継承元 DbDataAdapter)
Update(DataSet)

指定した DataSet での挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。

(継承元 DbDataAdapter)
Update(DataSet, String)

DataSet 内の指定した DataTable 名を持つ挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。

(継承元 DbDataAdapter)
Update(DataTable)

指定した DataTable での挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。

(継承元 DbDataAdapter)

イベント

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。

(継承元 Component)
FillError

格納操作中にエラーが発生したときに返されます。

(継承元 DbDataAdapter)
RowUpdated

Update(DataSet) 処理中に、データ ソースに対してコマンドが実行された後に発生します。 更新処理が試行されました。 そのため、イベントが発生しました。

RowUpdating

Update(DataSet) 処理中に、データ ソースに対してコマンドが実行される前に発生します。 更新処理が試行されました。 そのため、イベントが発生しました。

明示的なインターフェイスの実装

ICloneable.Clone()

このメンバーの詳細については、「Clone()」をご覧ください。

IDataAdapter.TableMappings

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

(継承元 DataAdapter)
IDbDataAdapter.DeleteCommand

このメンバーの詳細については、「DeleteCommand」をご覧ください。

IDbDataAdapter.InsertCommand

このメンバーの詳細については、「InsertCommand」をご覧ください。

IDbDataAdapter.SelectCommand

このメンバーの詳細については、「SelectCommand」をご覧ください。

IDbDataAdapter.UpdateCommand

このメンバーの詳細については、「UpdateCommand」をご覧ください。

適用対象

こちらもご覧ください