DataAdapter.Fill Metode

Definisi

Ruang nama:

System.Data.Common

Rakitan:

System.Data.Common.dll

Menambahkan atau merefresh baris di DataSet agar sesuai dengan baris di sumber data.

Overload

Fill(DataSet)	Menambahkan atau merefresh baris di DataSet agar sesuai dengan baris di sumber data.
Fill(DataTable, IDataReader)	Menambahkan atau menyegarkan baris di DataTable agar sesuai dengan baris di sumber data menggunakan DataTable nama dan yang ditentukan IDataReader.
Fill(DataTable[], IDataReader, Int32, Int32)	Menambahkan atau merefresh baris dalam rentang tertentu dalam kumpulan DataTable objek agar sesuai dengan baris di sumber data.
Fill(DataSet, String, IDataReader, Int32, Int32)	Menambahkan atau merefresh baris dalam rentang tertentu agar DataSet sesuai dengan baris di sumber data menggunakan DataSet nama dan DataTable .

Fill(DataSet)

Sumber:

DataAdapter.cs

Menambahkan atau merefresh baris di DataSet agar sesuai dengan baris di sumber data.

public:
 virtual int Fill(System::Data::DataSet ^ dataSet);

public virtual int Fill (System.Data.DataSet dataSet);

abstract member Fill : System.Data.DataSet -> int
override this.Fill : System.Data.DataSet -> int

Public Overridable Function Fill (dataSet As DataSet) As Integer

Parameter

dataSet

DataSet

DataSet untuk mengisi dengan rekaman dan, jika perlu, skema.

Mengembalikan

Int32

Jumlah baris yang berhasil ditambahkan ke atau disegarkan di DataSet. Ini tidak termasuk baris yang dipengaruhi oleh pernyataan yang tidak mengembalikan baris.

Penerapan

Fill(DataSet)

Keterangan

Metode mengambil Fill baris dari sumber data menggunakan pernyataan SELECT yang ditentukan oleh properti terkait SelectCommand . Objek koneksi yang terkait dengan pernyataan SELECT harus valid, tetapi tidak perlu dibuka. Jika koneksi ditutup sebelum Fill dipanggil, koneksi dibuka untuk mengambil data, lalu ditutup. Jika koneksi terbuka sebelum Fill dipanggil, koneksi tetap terbuka.

Fill Operasi kemudian menambahkan baris ke objek tujuan DataTable di DataSet, membuat DataTable objek jika belum ada. Saat membuat DataTable objek, Fill operasi biasanya hanya membuat metadata nama kolom. Namun, jika MissingSchemaAction properti diatur ke AddWithKey, kunci primer dan batasan yang sesuai juga dibuat.

Jika SelectCommand mengembalikan hasil GABUNGAN LUAR, maka DataAdapter tidak akan mengatur nilai PrimaryKey untuk menghasilkan DataTable. Anda harus secara eksplisit menentukan kunci primer untuk memastikan bahwa baris duplikat diselesaikan dengan benar. Untuk informasi selengkapnya, lihat Menentukan Kunci Utama.

Jika adaptor data menemukan kolom duplikat saat mengisi DataTable, adaptor data menghasilkan nama untuk kolom berikutnya, menggunakan pola "columnname1", "columnname2", "columnname3", dan sebagainya. Jika data masuk berisi kolom yang tidak disebutkan namanya, data tersebut ditempatkan sesuai DataSet dengan pola "Column1", "Column2", dan sebagainya. Ketika beberapa tataan hasil ditambahkan ke setiap tataan DataSet hasil ditempatkan dalam tabel terpisah. Tataan hasil tambahan dinamai dengan menambahkan nilai integral ke nama tabel yang ditentukan (misalnya, "Tabel", "Table1", "Table2", dan sebagainya). Aplikasi yang menggunakan nama kolom dan tabel harus memastikan bahwa konflik dengan pola penamaan ini tidak terjadi.

Ketika pernyataan SELECT yang digunakan untuk mengisi DataSet mengembalikan beberapa hasil, seperti pernyataan SQL batch, jika salah satu hasil berisi kesalahan, semua hasil berikutnya dilewati dan tidak ditambahkan ke DataSet.

Anda dapat menggunakan Fill metode beberapa kali pada yang sama DataTable. Jika ada kunci primer, baris masuk digabungkan dengan baris yang cocok yang sudah ada. Jika tidak ada kunci primer, baris masuk ditambahkan ke DataTable.

Catatan

Saat menangani pernyataan SQL batch yang mengembalikan beberapa hasil, implementasi FillSchema untuk Penyedia Data .NET Framework untuk OLE DB mengambil informasi skema hanya untuk hasil pertama. Untuk mengambil informasi skema untuk beberapa hasil, gunakan Fill dengan diatur MissingSchemaAction ke AddWithKey.

Lihat juga

• FillSchema(DataSet, SchemaType)
• Ringkasan ADO.NET

Fill(DataTable, IDataReader)

Sumber:

DataAdapter.cs

Menambahkan atau menyegarkan baris di DataTable agar sesuai dengan baris di sumber data menggunakan DataTable nama dan yang ditentukan 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

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

Parameter

dataTable

DataTable

A DataTable untuk mengisi dengan rekaman.

dataReader

IDataReader

Instans IDataReader.

Mengembalikan

Int32

Jumlah baris yang berhasil ditambahkan ke atau disegarkan di DataTable. Ini tidak termasuk baris yang dipengaruhi oleh pernyataan yang tidak mengembalikan baris.

Keterangan

Lihat keterangan untuk DataAdapter.Fill(DataSet) informasi tambahan.

Lihat juga

• Ringkasan ADO.NET

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

Sumber:

DataAdapter.cs

Menambahkan atau merefresh baris dalam rentang tertentu dalam kumpulan DataTable objek agar sesuai dengan baris di sumber data.

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

Parameter

dataTables

DataTable[]

Kumpulan DataTable objek untuk diisi dengan rekaman.

dataReader

IDataReader

Instans IDataReader.

startRecord

Int32

Indeks berbasis nol dari rekaman awal.

maxRecords

Int32

Bilangan bulat yang menunjukkan jumlah maksimum rekaman.

Mengembalikan

Int32

Jumlah baris yang berhasil ditambahkan ke atau disegarkan di DataTable. Ini tidak termasuk baris yang dipengaruhi oleh pernyataan yang tidak mengembalikan baris.

Keterangan

Lihat keterangan untuk System.Data.Common.DataAdapter.Fill(System.Data.DataSet) informasi tambahan.

Lihat juga

• Ringkasan ADO.NET

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

Sumber:

DataAdapter.cs

Menambahkan atau merefresh baris dalam rentang tertentu agar DataSet sesuai dengan baris di sumber data menggunakan DataSet nama dan DataTable .

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

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

Parameter

dataSet

DataSet

A DataSet untuk mengisi dengan rekaman.

srcTable

String

String yang menunjukkan nama tabel sumber.

dataReader

IDataReader

Instans IDataReader.

startRecord

Int32

Indeks berbasis nol dari rekaman awal.

maxRecords

Int32

Bilangan bulat yang menunjukkan jumlah maksimum rekaman.

Mengembalikan

Int32

Jumlah baris yang berhasil ditambahkan ke atau disegarkan di DataSet. Ini tidak termasuk baris yang dipengaruhi oleh pernyataan yang tidak mengembalikan baris.

Keterangan

Lihat keterangan untuk System.Data.Common.DataAdapter.Fill(System.Data.DataSet) informasi tambahan.

Lihat juga

• Ringkasan ADO.NET