DataAdapter.Fillとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataAdapter.Fill メソッド (DataSet)

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

名前空間: System.Data.Common
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 Fill ( _
    dataSet As DataSet _
) As Integer

Visual Basic (使用法)

Dim instance As DataAdapter
Dim dataSet As DataSet
Dim returnValue As Integer

returnValue = instance.Fill(dataSet)

public virtual int Fill (
    DataSet dataSet
)

C++

public:
virtual int Fill (
    DataSet^ dataSet
)

public int Fill (
    DataSet dataSet
)

JScript

public function Fill (
    dataSet : DataSet
) : int

パラメータ

dataSet: レコードおよび必要に応じてスキーマを格納するための DataSet。

戻り値
DataSet で正常に追加または更新された行数。これには、行を返さないステートメントの影響を受ける行は含まれません。

解説

Fill メソッドは、関連付けられた SelectCommand プロパティで指定された SELECT ステートメントを使用して、データソースから行を取得します。SELECT ステートメントに関連付けられた接続オブジェクトは、有効なものでなければなりませんが、開いている必要はありません。Fill を呼び出す前に接続が閉じていた場合は、接続が開かれ、データを取得した後で再び閉じられます。Fill を呼び出す前に接続が開いていた場合は、接続は開いたままになります。

次に、Fill は、DataSet 内にある追加先の DataTable オブジェクトに行を追加します。DataTable オブジェクトが存在しない場合は、新しく作成します。DataTable オブジェクトを作成する場合、Fill は、通常、列名メタデータのみを作成します。ただし、MissingSchemaAction プロパティが AddWithKey に設定されている場合は、適切な主キーおよび制約も作成します。

SelectCommand から OUTER JOIN の結果が返された場合、DataAdapter は、結果の DataTable に PrimaryKey の値を設定しません。行の重複が正しく解決されるようにするには、明示的に主キーを定義する必要があります。詳細については、「テーブルの主キーの定義」を参照してください。

DataTable へのデータの格納中に重複する列が見つかった場合は、データアダプタによって、columnname1、columnname2、columnname3 のような形式で後続の列の名前が生成されます。受信したデータに無名の列が含まれていた場合は、Column1、Column2 のような形式の名前で DataSet に列が格納されます。DataSet に複数結果セットを追加するときは、各結果セットが個別のテーブルに格納されます。2 番目以降の結果セットには、指定されたテーブル名に整数値を追加した名前が付けられます。たとえば、Table、Table1、Table2 のようになります。アプリケーションで列名およびテーブル名を使用するときは、これらの名前付けパターンとの衝突が発生しないように注意する必要があります。

バッチ SQL ステートメントなど、DataSet へのデータの格納に使用する SELECT ステートメントが複数の結果を返す場合は、結果の 1 つにエラーが含まれていると、それ以降の結果はすべてスキップされ、DataSet に追加されません。

Fill メソッドは、同じ DataTable に対して複数回使用できます。主キーが存在する場合は、受信した行が既存の一致する行とマージされます。主キーが存在しない場合は、受信した行が DataTable に追加されます。

メモ
複数の結果を返すバッチ SQL ステートメントを処理する場合、.NET Framework OLE DB 用データプロバイダの FillSchema の実装では、最初の結果のスキーマ情報だけが取得されます。複数の結果のスキーマ情報を取得するには、MissingSchemaAction を AddWithKey に設定して Fill を使用します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataAdapter クラス
DataAdapter メンバ
System.Data.Common 名前空間
FillSchema

DataAdapter.Fill メソッド (DataTable, IDataReader)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Data.Common
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Function
 Fill ( _
    dataTable As DataTable, _
    dataReader As IDataReader _
) As Integer

Visual Basic (使用法)

Dim dataTable As DataTable
Dim dataReader As IDataReader
Dim returnValue As Integer

returnValue = Me.Fill(dataTable, dataReader)

protected virtual int Fill (
    DataTable dataTable,
    IDataReader dataReader
)

C++

protected:
virtual int Fill (
    DataTable^ dataTable, 
    IDataReader^ dataReader
)

protected int Fill (
    DataTable dataTable, 
    IDataReader dataReader
)

JScript

protected function Fill (
    dataTable : DataTable, 
    dataReader : IDataReader
) : int

パラメータ

dataTable: レコードの格納先の DataTable。

dataReader: IDataReader のインスタンス。

戻り値
DataSet で正常に追加または更新された行数。これには、行を返さないステートメントの影響を受ける行は含まれません。

解説

詳細については、Fill の解説を参照してください。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
DataAdapter クラス
DataAdapter メンバ
System.Data.Common 名前空間

DataAdapter.Fill メソッド (DataTable[], IDataReader, Int32, Int32)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Data.Common
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Function
 Fill ( _
    dataTables As DataTable(), _
    dataReader As IDataReader, _
    startRecord As Integer, _
    maxRecords As Integer _
) As Integer

Visual Basic (使用法)

Dim dataTables As DataTable()
Dim dataReader As IDataReader
Dim startRecord As Integer
Dim maxRecords As Integer
Dim returnValue As Integer

returnValue = Me.Fill(dataTables, dataReader, startRecord, maxRecords)

protected virtual int Fill (
    DataTable[] dataTables,
    IDataReader dataReader,
    int startRecord,
    int maxRecords
)

C++

protected:
virtual int Fill (
    array<DataTable^>^ dataTables, 
    IDataReader^ dataReader, 
    int startRecord, 
    int maxRecords
)

protected int Fill (
    DataTable[] dataTables, 
    IDataReader dataReader, 
    int startRecord, 
    int maxRecords
)

JScript

protected function Fill (
    dataTables : DataTable[], 
    dataReader : IDataReader, 
    startRecord : int, 
    maxRecords : int
) : int

パラメータ

dataTables: レコードの格納先の DataTable オブジェクトのコレクション。

dataReader: IDataReader のインスタンス。

startRecord: 開始レコードの位置を示す整数。

maxRecords: 最大レコード数を示す整数。

戻り値
DataTable で正常に追加または更新された行数。これには、行を返さないステートメントの影響を受ける行は含まれません。

解説

詳細については、Fill の解説を参照してください。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
DataAdapter クラス
DataAdapter メンバ
System.Data.Common 名前空間

DataAdapter.Fill メソッド

DataSet 名を使用して、データソース内の行と一致するように、DataSet 内の行を追加または更新します。また、DataTable を作成します。
オーバーロードの一覧

名前	説明
DataAdapter.Fill (DataSet)	DataSet 名を使用して、データソース内の行と一致するように、DataSet 内の行を追加または更新します。また、DataTable を作成します。 .NET Compact Framework によってサポートされています。
DataAdapter.Fill (DataTable, IDataReader)	DataSet 名を使用して、データソース内の行と一致するように、DataSet 内の行を追加または更新します。また、DataTable を作成します。 .NET Compact Framework によってサポートされています。
DataAdapter.Fill (DataTable[], IDataReader, Int32, Int32)	DataSet 名を使用して、データソース内の行と一致するように、DataSet 内の行を追加または更新します。また、DataTable を作成します。 .NET Compact Framework によってサポートされています。
DataAdapter.Fill (DataSet, String, IDataReader, Int32, Int32)	DataSet 名を使用して、データソース内の行と一致するように、DataSet 内の行を追加または更新します。また、DataTable を作成します。 .NET Compact Framework によってサポートされています。

参照

DataAdapter.Fill メソッド (DataSet, String, IDataReader, Int32, Int32)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Data.Common
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Function
 Fill ( _
    dataSet As DataSet, _
    srcTable As String, _
    dataReader As IDataReader, _
    startRecord As Integer, _
    maxRecords As Integer _
) As Integer

Visual Basic (使用法)

Dim dataSet As DataSet
Dim srcTable As String
Dim dataReader As IDataReader
Dim startRecord As Integer
Dim maxRecords As Integer
Dim returnValue As Integer

returnValue = Me.Fill(dataSet, srcTable, dataReader, startRecord,
 maxRecords)

protected virtual int Fill (
    DataSet dataSet,
    string srcTable,
    IDataReader dataReader,
    int startRecord,
    int maxRecords
)

C++

protected:
virtual int Fill (
    DataSet^ dataSet, 
    String^ srcTable, 
    IDataReader^ dataReader, 
    int startRecord, 
    int maxRecords
)

protected int Fill (
    DataSet dataSet, 
    String srcTable, 
    IDataReader dataReader, 
    int startRecord, 
    int maxRecords
)

JScript

protected function Fill (
    dataSet : DataSet, 
    srcTable : String, 
    dataReader : IDataReader, 
    startRecord : int, 
    maxRecords : int
) : int

パラメータ