DataAdapter クラス

定義

DataSet へのデータの格納およびデータ ソースの更新に使用される、一連の SQL コマンドおよびデータベース接続を表します。Represents a set of SQL commands and a database connection that are used to fill the DataSet and update the data source.

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

注釈

は、 DataAdapter DataSet データの取得と保存のためのとデータソース間のブリッジとして機能します。The DataAdapter serves as a bridge between a DataSet and a data source for retrieving and saving data. は、 DataAdapter このブリッジをマッピングによって提供します。これにより、 Fill データソース内のデータと一致するように内のデータが変更され、データソース内のデータがのデータと DataSet Update 一致するように変更され DataSet ます。The DataAdapter provides this bridge by mapping Fill, which changes the data in the DataSet to match the data in the data source, and Update, which changes the data in the data source to match the data in the DataSet.

SQL Server データベースに接続している場合は、 SqlDataAdapter とそれに関連付けられたオブジェクトを使用して、全体的なパフォーマンスを向上させることができ SqlCommand SqlConnection ます。If you are connecting to a SQL Server database, you can increase overall performance by using the SqlDataAdapter along with its associated SqlCommand and SqlConnection objects. OLE DB サポートされているデータソースの場合は、 DataAdapter と、それに関連付けられたオブジェクトを使用し OleDbCommand OleDbConnection ます。For OLE DB-supported data sources, use the DataAdapter with its associated OleDbCommand and OleDbConnection objects. ODBC でサポートされているデータソースの場合は、 DataAdapter およびオブジェクトに関連付けられているを使用し OdbcCommand OdbcConnection ます。For ODBC-supported data sources, use the DataAdapter with its associated OdbcCommand and OdbcConnection objects. Oracle データベースの場合は、 DataAdapter とそれに関連付けられたオブジェクトを使用し OracleCommand OracleConnection ます。For Oracle databases, use the DataAdapter with its associated OracleCommand and OracleConnection objects.

のインスタンスが作成されると DataAdapter 、読み取り/書き込みプロパティが初期値に設定されます。When an instance of DataAdapter is created, the read/write properties are set to initial values. これらの値の一覧については、「コンストラクター」を参照してください DataAdapterFor a list of these values, see the DataAdapter constructor.

コンストラクター

DataAdapter()

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

DataAdapter(DataAdapter)

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

プロパティ

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.

AcceptChangesDuringUpdate

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

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.

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)
FillLoadOption

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

MissingMappingAction

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

MissingSchemaAction

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

ReturnProviderSpecificTypes

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

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.

メソッド

CloneInternals()
互換性のために残されています。
互換性のために残されています。
互換性のために残されています。

この DataAdapter のインスタンスのコピーを作成します。Creates a copy of this instance of 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)
CreateTableMappings()

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

Dispose()

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

(継承元 Component)
Dispose(Boolean)

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

Equals(Object)

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

(継承元 Object)
Fill(DataSet)

データ ソース内の行と一致するように、DataSet の行を追加または更新します。Adds or refreshes rows in the DataSet to match those in the data source.

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

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(DataTable, IDataReader)

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

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.

FillSchema(DataSet, SchemaType)

指定した 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, IDataReader)

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

FillSchema(DataTable, SchemaType, IDataReader)

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

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.

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)

Fill 中にエラーが発生したときに呼び出されます。Invoked when an error occurs during a Fill.

ResetFillLoadOption()

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

ShouldSerializeAcceptChangesDuringFill()

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

ShouldSerializeFillLoadOption()

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

ShouldSerializeTableMappings()

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

ToString()

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

(継承元 Component)
Update(DataSet)

指定された DataSet 内の "Table" という名前の DataTable に含まれる挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet from a DataTable named "Table."

イベント

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.

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

IDataAdapter.TableMappings

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

適用対象

こちらもご覧ください