DataAdapter.Fill メソッド

定義

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

オーバーロード

Fill(DataSet)

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

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.

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(DataSet)

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

public:
 abstract int Fill(System::Data::DataSet ^ dataSet);
public abstract int Fill (System.Data.DataSet dataSet);
abstract member Fill : System.Data.DataSet -> int

パラメーター

dataSet
DataSet

レコードおよび必要に応じてスキーマを格納するための DataSetA DataSet to fill with records and, if necessary, schema.

戻り値

DataSet で正常に追加または更新された行数。The number of rows successfully added to or refreshed in the DataSet. これには、行を返さないステートメントの影響を受ける行は含まれません。This does not include rows affected by statements that do not return rows.

実装

注釈

Fill メソッドは、関連付けられた SelectCommand プロパティによって指定された SELECT ステートメントを使用して、データソースから行を取得します。The Fill method retrieves rows from the data source using the SELECT statement specified by an associated SelectCommand property. SELECT ステートメントに関連付けられている接続オブジェクトは有効である必要がありますが、開く必要はありません。The connection object associated with the SELECT statement must be valid, but it does not need to be open. Fill が呼び出される前に接続が閉じられた場合は、データを取得して閉じた状態で接続が開かれます。If the connection is closed before Fill is called, it is opened to retrieve data, then closed. Fill が呼び出される前に接続が開いている場合は、開いたままになります。If the connection is open before Fill is called, it remains open.

次に、Fill 操作は、DataSet内の変換先 DataTable オブジェクトに行を追加し、存在しない場合は DataTable オブジェクトを作成します。The Fill operation then adds the rows to destination DataTable objects in the DataSet, creating the DataTable objects if they do not already exist. DataTable オブジェクトを作成する場合、Fill 操作では通常、列名のメタデータのみが作成されます。When creating DataTable objects, the Fill operation normally creates only column name metadata. ただし、MissingSchemaAction プロパティが AddWithKeyに設定されている場合は、適切な主キーと制約も作成されます。However, if the MissingSchemaAction property is set to AddWithKey, appropriate primary keys and constraints are also created.

SelectCommand が OUTER JOIN の結果を返す場合、 DataAdapter は、生成される PrimaryKeyDataTable値を設定しません。If the SelectCommand returns the results of an OUTER JOIN, the DataAdapter does not set a PrimaryKey value for the resulting DataTable. 重複行が正しく解決されるようにするには、主キーを明示的に定義する必要があります。You must explicitly define the primary key to ensure that duplicate rows are resolved correctly. 詳細については、「主キーの定義」を参照してください。For more information, see Defining Primary Keys.

DataTableの設定中にデータアダプターで重複する列が検出されると、"columnname1"、"columnname2"、"columnname3" などのパターンを使用して、後続の列の名前が生成されます。If the data adapter encounters duplicate columns while populating a DataTable, it generates names for the subsequent columns, using the pattern "columnname1", "columnname2", "columnname3", and so on. 受信データに名前のない列が含まれている場合、"Column1"、"Column2" などのパターンに従って DataSet に配置されます。If the incoming data contains unnamed columns, they are placed in the DataSet according to the pattern "Column1", "Column2", and so on. 複数の結果セットが DataSet に追加されると、各結果セットが個別のテーブルに配置されます。When multiple result sets are added to the DataSet each result set is placed in a separate table. 追加の結果セットには、指定されたテーブル名に整数値を追加することによって名前が付けられます (たとえば、"Table"、"Table1"、"Table2" など)。Additional result sets are named by appending integral values to the specified table name (for example, "Table", "Table1", "Table2", and so on). 列名とテーブル名を使用するアプリケーションでは、これらの名前付けパターンとの競合が発生しないようにする必要があります。Applications using column and table names should ensure that conflicts with these naming patterns does not occur.

DataSet を設定するために使用される SELECT ステートメントが複数の結果 (バッチ SQL ステートメントなど) を返す場合、結果の1つにエラーが含まれていると、それ以降の結果はすべてスキップされ、DataSetには追加されません。When the SELECT statement used to populate the DataSet returns multiple results, such as a batch SQL statements, if one of the results contains an error, all subsequent results are skipped and not added to the DataSet.

同じ DataTableFill メソッドを複数回使用できます。You can use the Fill method multiple times on the same DataTable. 主キーが存在する場合、受信した行は、既に存在する一致する行とマージされます。If a primary key exists, incoming rows are merged with matching rows that already exist. 主キーが存在しない場合は、受信行が DataTableに追加されます。If no primary key exists, incoming rows are appended to the DataTable.

注意

複数の結果を返すバッチ SQL ステートメントを処理する場合、OLE DB の .NET Framework Data Provider の FillSchema の実装では、最初の結果のみのスキーマ情報を取得します。When handling batch SQL statements that return multiple results, the implementation of FillSchema for the .NET Framework Data Provider for OLE DB retrieves schema information for only the first result. 複数の結果のスキーマ情報を取得するには、MissingSchemaActionAddWithKeyに設定して Fill を使用します。To retrieve schema information for multiple results, use Fill with the MissingSchemaAction set to AddWithKey.

こちらもご覧ください

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.

protected:
 virtual int Fill(System::Data::DataTable ^ dataTable, System::Data::IDataReader ^ dataReader);
protected virtual int Fill (System.Data.DataTable dataTable, System.Data.IDataReader dataReader);
abstract member Fill : System.Data.DataTable * System.Data.IDataReader -> int
override this.Fill : System.Data.DataTable * System.Data.IDataReader -> int

パラメーター

dataTable
DataTable

レコードの格納先の DataTableA DataTable to fill with records.

dataReader
IDataReader

IDataReader のインスタンス。An instance of IDataReader.

戻り値

DataTable で正常に追加または更新された行数。The number of rows successfully added to or refreshed in the DataTable. これには、行を返さないステートメントの影響を受ける行は含まれません。This does not include rows affected by statements that do not return rows.

注釈

詳細については、DataAdapter.Fill(DataSet) の解説を参照してください。See the remarks for DataAdapter.Fill(DataSet) for additional information.

こちらもご覧ください

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.

protected:
 virtual int Fill(cli::array <System::Data::DataTable ^> ^ dataTables, System::Data::IDataReader ^ dataReader, int startRecord, int maxRecords);
protected virtual int Fill (System.Data.DataTable[] dataTables, System.Data.IDataReader dataReader, int startRecord, int maxRecords);
abstract member Fill : System.Data.DataTable[] * System.Data.IDataReader * int * int -> int
override this.Fill : System.Data.DataTable[] * System.Data.IDataReader * int * int -> int
Protected Overridable Function Fill (dataTables As DataTable(), dataReader As IDataReader, startRecord As Integer, maxRecords As Integer) As Integer

パラメーター

dataTables
DataTable[]

レコードの格納先の DataTable オブジェクトのコレクション。A collection of DataTable objects to fill with records.

dataReader
IDataReader

IDataReader のインスタンス。An instance of IDataReader.

startRecord
Int32

開始レコードの 0 から始まるインデックス。The zero-based index of the starting record.

maxRecords
Int32

最大レコード数を示す整数。An integer indicating the maximum number of records.

戻り値

DataTable で正常に追加または更新された行数。The number of rows successfully added to or refreshed in the DataTable. これには、行を返さないステートメントの影響を受ける行は含まれません。This does not include rows affected by statements that do not return rows.

注釈

詳細については、System.Data.Common.DataAdapter.Fill(System.Data.DataSet) の解説を参照してください。See the remarks for System.Data.Common.DataAdapter.Fill(System.Data.DataSet) for additional information.

こちらもご覧ください

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.

protected:
 virtual int Fill(System::Data::DataSet ^ dataSet, System::String ^ srcTable, System::Data::IDataReader ^ dataReader, int startRecord, int maxRecords);
protected virtual int Fill (System.Data.DataSet dataSet, string srcTable, System.Data.IDataReader dataReader, int startRecord, int maxRecords);
abstract member Fill : System.Data.DataSet * string * System.Data.IDataReader * int * int -> int
override this.Fill : System.Data.DataSet * string * System.Data.IDataReader * int * int -> int

パラメーター

dataSet
DataSet

レコードの格納先の DataSetA DataSet to fill with records.

srcTable
String

ソース テーブルの名前を示す文字列。A string indicating the name of the source table.

dataReader
IDataReader

IDataReader のインスタンス。An instance of IDataReader.

startRecord
Int32

開始レコードの 0 から始まるインデックス。The zero-based index of the starting record.

maxRecords
Int32

最大レコード数を示す整数。An integer indicating the maximum number of records.

戻り値

DataSet で正常に追加または更新された行数。The number of rows successfully added to or refreshed in the DataSet. これには、行を返さないステートメントの影響を受ける行は含まれません。This does not include rows affected by statements that do not return rows.

注釈

詳細については、System.Data.Common.DataAdapter.Fill(System.Data.DataSet) の解説を参照してください。See the remarks for System.Data.Common.DataAdapter.Fill(System.Data.DataSet) for additional information.

こちらもご覧ください

適用対象