DbDataAdapter クラス

定義

IDbDataAdapter インターフェイスの実装を支援します。Aids implementation of the IDbDataAdapter interface. DbDataAdapter の継承クラスは、厳密な型指定を行う関数のセットを実装しますが、DataAdapter を完全に実装するために必要な機能の大部分は継承します。Inheritors of DbDataAdapter implement a set of functions to provide strong typing, but inherit most of the functionality needed to fully implement a DataAdapter.

public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable, System::Data::IDbDataAdapter
public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapter
type DbDataAdapter = class
    inherit DataAdapter
    interface IDbDataAdapter
    interface ICloneable
    interface IDataAdapter
Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapter
継承
派生
実装

注釈

クラスDbDataAdapterは、 DataAdapterクラスから継承し、 IDbDataAdapterインターフェイスを実装します。The DbDataAdapter class inherits from the DataAdapter class and implements the IDbDataAdapter interface. クラスは、リレーショナルデータベースで使用するように設計されたDataAdapterを実装するのに役立ちます。It helps a class implement a DataAdapter designed for use with a relational database.

アプリケーションは、 DbDataAdapterクラスのインスタンスを直接作成するのではなく、それを継承するクラスのインスタンスを作成します。An application does not create an instance of the DbDataAdapter class directly, but creates an instance of a class that inherits from it.

継承DbDataAdapterするクラスは、継承されたメンバーを実装する必要があり、通常は、プロバイダー固有の機能を追加するための追加メンバーを定義します。Classes that inherit DbDataAdapter must implement the inherited members, and typically define additional members to add provider-specific functionality. たとえば、クラスはDbDataAdapter SelectCommandプロパティを定義し、クラスはDbDataAdapter Fillメソッドの8個のオーバーロードを定義します。For example, the DbDataAdapter class defines the SelectCommand property, and the DbDataAdapter class defines eight overloads of the Fill method. 次に、クラスOleDbDataAdapterFillメソッドを継承し、ADO レコードセットオブジェクトをパラメーター Fillとして受け取るの2つの追加のオーバーロードも定義します。In turn, the OleDbDataAdapter class inherits the Fill method, and also defines two additional overloads of Fill that take an ADO Recordset object as a parameter.

注意 (実装者)

DbDataAdapterクラスから継承する場合は、次のコンストラクターを実装することをお勧めします。When you inherit from the DbDataAdapter class, we recommend that you implement the following constructors:

アイテムItem 説明Description
*場合*DataAdapter ()*Prv*DataAdapter() *場合*DataAdapter クラスの新しいインスタンスを初期化します。Initializes a new instance of the *Prv*DataAdapter class.
*場合*DataAdapter (*場合*コマンド*selectCommand*)*Prv*DataAdapter(*Prv*Command *selectCommand*) 指定した SQL SELECT ステートメントを使用して、*場合*DataAdapter クラスの新しいインスタンスを初期化します。Initializes a new instance of the *Prv*DataAdapter class with the specified SQL SELECT statement.
*場合*DataAdapter (string *Selectcommandtext*、String *selectcommandtext*)*Prv*DataAdapter(string *selectCommandText*, string *selectConnectionString*) SQL SELECT ステートメントと接続文字列を使用して、*場合*DataAdapter クラスの新しいインスタンスを初期化します。Initializes a new instance of the *Prv*DataAdapter class with an SQL SELECT statement and a connection string.
*場合*DataAdapter (string *Selectcommandtext*、*場合*Connection *selectcommandtext*)*Prv*DataAdapter(string *selectCommandText*, *Prv*Connection *selectConnection*) SQL SELECT ステートメントと*場合*Connection オブジェクトを使用して、*場合*DataAdapter クラスの新しいインスタンスを初期化します。Initializes a new instance of the *Prv*DataAdapter class with an SQL SELECT statement and a *Prv*Connection object.

.NET Framework データプロバイダー間の一貫性を高めるには、場合DataAdapter の形式で継承クラスに名前を付けます。場合は、特定の .NET Framework データプロバイダーの名前空間のすべてのクラスに指定された均一なプレフィックスです。To promote consistency among .NET Framework data providers, you should name the inheriting class in the form PrvDataAdapter, where Prv is the uniform prefix given to all classes in a specific .NET Framework data provider namespace. たとえば、"Sql" は、 SqlDataAdapter system.string 名前空間のクラスのプレフィックスです。For example, "Sql" is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

コンストラクター

DbDataAdapter()

DataAdapter クラスの新しいインスタンスを初期化します。Initializes a new instance of a DataAdapter class.

DbDataAdapter(DbDataAdapter)

既存の同じ型のオブジェクトから、DataAdapter クラスの新しいインスタンスを初期化します。Initializes a new instance of a DataAdapter class from an existing object of the same type.

フィールド

DefaultSourceTableName

DataAdapter オブジェクトがテーブル マップに使用する既定の名前。The default name used by the DataAdapter object for table mappings.

プロパティ

AcceptChangesDuringFill

Fill 操作中に DataTableDataRow が追加された後で、その行に対して AcceptChanges() を呼び出すかどうかを示す値を取得または設定します。Gets or sets a value indicating whether AcceptChanges() is called on a DataRow after it is added to the DataTable during any of the Fill operations.

(継承元 DataAdapter)
AcceptChangesDuringUpdate

AcceptChanges()Update(DataSet) が呼び出されるかどうかを取得または設定します。Gets or sets whether AcceptChanges() is called during a Update(DataSet).

(継承元 DataAdapter)
CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。Gets a value indicating whether the component can raise an event.

(継承元 Component)
Container

IContainer を格納している Component を取得します。Gets the IContainer that contains the Component.

(継承元 Component)
ContinueUpdateOnError

行の更新中にエラーが発生したときに、例外を生成するかどうかを指定する値を取得または設定します。Gets or sets a value that specifies whether to generate an exception when an error is encountered during a row update.

(継承元 DataAdapter)
DeleteCommand

データ セットからレコードを削除するコマンドを取得または設定します。Gets or sets a command for deleting records from the data set.

DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。Gets a value that indicates whether the Component is currently in design mode.

(継承元 Component)
Events

Component に結び付けられているイベント ハンドラーのリストを取得します。Gets the list of event handlers that are attached to this Component.

(継承元 Component)
FillCommandBehavior

データ アダプターにデータを読み込むコマンドの動作を取得または設定します。Gets or sets the behavior of the command used to fill the data adapter.

FillLoadOption

アダプターが LoadOption から DataTable にデータを読み込む方法を決定する DbDataReader を取得または設定します。Gets or sets the LoadOption that determines how the adapter fills the DataTable from the DbDataReader.

(継承元 DataAdapter)
InsertCommand

データ ソースに新しいレコードを挿入するコマンドを取得または設定します。Gets or sets a command used to insert new records into the data source.

MissingMappingAction

一致するテーブルまたは列が受信データに含まれていない場合に実行するアクションを決定します。Determines the action to take when incoming data does not have a matching table or column.

(継承元 DataAdapter)
MissingSchemaAction

既存の DataSet スキーマが受信データと一致しないときに実行するアクションを決定します。Determines the action to take when existing DataSet schema does not match incoming data.

(継承元 DataAdapter)
ReturnProviderSpecificTypes

Fill メソッドがプロバイダー固有の値、または共通の CLS 準拠の値のどちらを返すかを取得または設定します。Gets or sets whether the Fill method should return provider-specific values or common CLS-compliant values.

(継承元 DataAdapter)
SelectCommand

データ ソース内のレコードを選択するコマンドを取得または設定します。Gets or sets a command used to select records in the data source.

Site

ComponentISite を取得または設定します。Gets or sets the ISite of the Component.

(継承元 Component)
TableMappings

ソース テーブルと DataTable との間のマスター マップを提供するコレクションを取得します。Gets a collection that provides the master mapping between a source table and a DataTable.

(継承元 DataAdapter)
UpdateBatchSize

バッチ処理サポートを有効にするかどうか、および、1 回のバッチで実行可能なコマンド数を指定する値を取得または設定します。Gets or sets a value that enables or disables batch processing support, and specifies the number of commands that can be executed in a batch.

UpdateCommand

データ ソース内のレコードを更新するコマンドを取得または設定します。Gets or sets a command used to update records in the data source.

メソッド

AddToBatch(IDbCommand)

IDbCommand を現在のバッチに追加します。Adds a IDbCommand to the current batch.

ClearBatch()

バッチからすべての IDbCommand オブジェクトを削除します。Removes all IDbCommand objects from the batch.

CloneInternals()

この DataAdapter のインスタンスのコピーを作成します。Creates a copy of this instance of DataAdapter.

(継承元 DataAdapter)
CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

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

RowUpdatedEventArgs クラスの新しいインスタンスを初期化します。Initializes a new instance of the RowUpdatedEventArgs class.

CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

RowUpdatingEventArgs クラスの新しいインスタンスを初期化します。Initializes a new instance of the RowUpdatingEventArgs class.

CreateTableMappings()

新しい DataTableMappingCollection を作成します。Creates a new DataTableMappingCollection.

(継承元 DataAdapter)
Dispose()

Component によって使用されているすべてのリソースを解放します。Releases all resources used by the Component.

(継承元 Component)
Dispose(Boolean)

DbDataAdapter によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the DbDataAdapter and optionally releases the managed resources.

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判定します。Determines whether the specified object is equal to the current object.

(継承元 Object)
ExecuteBatch()

現在のバッチを実行します。Executes the current batch.

Fill(DataSet)

DataSet 内の行を追加または更新します。Adds or refreshes rows in the DataSet.

Fill(DataSet, Int32, Int32, String)

DataSet 名および DataSet 名を使用して、データ ソース内の行と一致するように、DataTable 内の指定した範囲の行を追加または更新します。Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)

DataSet 名、ソース テーブル名、コマンド文字列、およびコマンド動作を使用して、データ ソース内の列と一致するように、DataSet 内の指定した範囲の行を追加または更新します。Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and source table names, command string, and command behavior.

Fill(DataSet, String)

DataSet 名および DataSet 名を使用して、データ ソース内の列と一致するように DataTable 内の行を追加または更新します。Adds or refreshes rows in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(DataSet, String, IDataReader, Int32, Int32)

DataSetDataTableIDataReader の名前を使用して、データ ソース内の行と一致するように、DataSet 内の指定した範囲の行を追加または更新します。Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet, DataTable, and IDataReader names.

Fill(DataTable)

DataSet 名を使用して、データ ソース内の行と一致するように、DataTable 内の指定した範囲の行を追加または更新します。Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataTable name.

Fill(DataTable, IDataReader)

指定した DataTableIDataReader の名前を使用して、データ ソース内の行と一致するように、DataTable 内の行を追加または更新します。Adds or refreshes rows in a DataTable to match those in the data source using the specified DataTable and IDataReader names.

Fill(DataTable, IDbCommand, CommandBehavior)

指定した DataTableDataTable、および IDbCommand を使用して、データ ソース内の行と一致するように、CommandBehavior 内の行を追加または更新します。Adds or refreshes rows in a DataTable to match those in the data source using the specified DataTable, IDbCommand and CommandBehavior.

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

データ ソース内の行と一致するように、DataTable オブジェクトのコレクション内の指定した範囲の行を追加または更新します。Adds or refreshes rows in a specified range in the collection of DataTable objects to match those in the data source.

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

DataSet 名および DataSet 名を使用して、データ ソース内の行と一致するように、DataTable 内の指定した範囲の行を追加または更新します。Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(Int32, Int32, DataTable[])

指定したレコード位置で開始し、指定した最大数のレコードを読み込んで、データ ソース内の行と一致するように、DataTable 内の行を追加または更新します。Adds or refreshes rows in a DataTable to match those in the data source starting at the specified record and retrieving up to the specified maximum number of records.

FillSchema(DataSet, SchemaType)

"Table" という名前の DataTable を指定された DataSet に追加し、指定された SchemaType に基づいて、データ ソースにあるスキーマと一致するようにスキーマを構成します。Adds a DataTable named "Table" to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)

指定した DataTableDataSet を追加し、指定した SchemaType に基づいて、データ ソース内のスキーマと一致するようにスキーマを設定します。Adds a DataTable to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

FillSchema(DataSet, SchemaType, String)

指定した DataTableDataSet を追加し、指定した SchemaType および DataTable に基づいて、データ ソース内のスキーマと一致するようにスキーマを設定します。Adds a DataTable to the specified DataSet and configures the schema to match that in the data source based upon the specified SchemaType and DataTable.

FillSchema(DataSet, SchemaType, String, IDataReader)

DataTable を指定した DataSet に追加します。Adds a DataTable to the specified DataSet.

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

指定した DataTable に基いて、指定した SchemaType のスキーマを設定します。Configures the schema of the specified DataTable based on the specified SchemaType.

FillSchema(DataTable, SchemaType, IDataReader)

DataTable を指定した DataSet に追加します。Adds a DataTable to the specified DataSet.

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

指定した DataTable、コマンド文字列、および SchemaType 値に基づいて、指定した CommandBehavior のスキーマを設定します。Configures the schema of the specified DataTable based on the specified SchemaType, command string, and CommandBehavior values.

GetBatchedParameter(Int32, Int32)

現在のバッチのコマンドの 1 つから IDataParameter を返します。Returns a IDataParameter from one of the commands in the current batch.

GetBatchedRecordsAffected(Int32, Int32, Exception)

バッチ更新内の、個々の更新の試行に関する情報を返します。Returns information about an individual update attempt within a larger batched update.

GetFillParameters()

SQL SELECT ステートメントの実行時にユーザーが設定したパラメーターを取得します。Gets the parameters set by the user when executing an SQL SELECT statement.

GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(継承元 MarshalByRefObject)
GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。Returns an object that represents a service provided by the Component or by its Container.

(継承元 Component)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
HasTableMappings()

DataTableMappingCollection が作成されているかどうかを示します。Indicates whether a DataTableMappingCollection has been created.

(継承元 DataAdapter)
InitializeBatching()

DbDataAdapter のバッチ処理を初期化します。Initializes batching for the DbDataAdapter.

InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(継承元 MarshalByRefObject)
OnFillError(FillErrorEventArgs)

FillError イベントを発生させます。Raises the FillError event.

OnRowUpdated(RowUpdatedEventArgs)

.NET Framework データ プロバイダーの RowUpdated イベントを発生させます。Raises the RowUpdated event of a .NET Framework data provider.

OnRowUpdating(RowUpdatingEventArgs)

.NET Framework データ プロバイダーの RowUpdating イベントを発生させます。Raises the RowUpdating event of a .NET Framework data provider.

ResetFillLoadOption()

FillLoadOption を既定の状態にリセットし、Fill(DataSet)AcceptChangesDuringFill を受け入れるようにします。Resets FillLoadOption to its default state and causes Fill(DataSet) to honor AcceptChangesDuringFill.

(継承元 DataAdapter)
ShouldSerializeAcceptChangesDuringFill()

AcceptChangesDuringFill プロパティを永続化する必要があるかどうかを判断します。Determines whether the AcceptChangesDuringFill property should be persisted.

(継承元 DataAdapter)
ShouldSerializeFillLoadOption()

FillLoadOption プロパティを永続化する必要があるかどうかを判断します。Determines whether the FillLoadOption property should be persisted.

(継承元 DataAdapter)
ShouldSerializeTableMappings()

1 つ以上の DataTableMapping オブジェクトが存在し、それらを永続化する必要があるかどうかを確認します。Determines whether one or more DataTableMapping objects exist and they should be persisted.

(継承元 DataAdapter)
TerminateBatching()

DbDataAdapter のバッチ処理を終了します。Ends batching for the DbDataAdapter.

ToString()

Component の名前 (存在する場合) を格納する String を返します。Returns a String containing the name of the Component, if any. このメソッドはオーバーライドできません。This method should not be overridden.

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

指定した DataSet 内の配列での挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified array in the DataSet.

Update(DataRow[], DataTableMapping)

指定した DataSet オブジェクトの配列内の挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified array of DataSet objects.

Update(DataSet)

指定した DataSet での挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet.

Update(DataSet, String)

DataSet 内の指定した DataTable 名を持つ挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the DataSet with the specified DataTable name.

Update(DataTable)

指定した DataTable での挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataTable.

イベント

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されると発生します。Occurs when the component is disposed by a call to the Dispose() method.

(継承元 Component)
FillError

格納操作中にエラーが発生したときに返されます。Returned when an error occurs during a fill operation.

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

ICloneable.Clone()

現在のインスタンスのコピーである新しいオブジェクトを作成します。Creates a new object that is a copy of the current instance.

IDataAdapter.TableMappings

ソース テーブルをデータセット テーブルに割り当てる方法を示します。Indicates how a source table is mapped to a dataset table.

(継承元 DataAdapter)
IDbDataAdapter.DeleteCommand

データ セットからレコードを削除する SQL ステートメントを取得または設定します。Gets or sets an SQL statement for deleting records from the data set.

IDbDataAdapter.InsertCommand

データ ソースに新しいレコードを挿入する SQL ステートメントを取得または設定します。Gets or sets an SQL statement used to insert new records into the data source.

IDbDataAdapter.SelectCommand

データ ソース内のレコードを選択する SQL ステートメントを取得または設定します。Gets or sets an SQL statement used to select records in the data source.

IDbDataAdapter.UpdateCommand

データ ソース内のレコードを更新する SQL ステートメントを取得または設定します。Gets or sets an SQL statement used to update records in the data source.

適用対象

こちらもご覧ください