DataAdapter.Fill Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- Sumber:
- DataAdapter.cs
- 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:
abstract int Fill(System::Data::DataSet ^ dataSet);
public virtual int Fill (System.Data.DataSet dataSet);
public abstract int Fill (System.Data.DataSet dataSet);
abstract member Fill : System.Data.DataSet -> int
override this.Fill : System.Data.DataSet -> int
abstract member Fill : System.Data.DataSet -> int
Public Overridable Function Fill (dataSet As DataSet) As Integer
Public MustOverride Function Fill (dataSet As DataSet) As Integer
Parameter
Mengembalikan
Jumlah baris yang berhasil ditambahkan ke atau disegarkan di DataSet. Ini tidak termasuk baris yang dipengaruhi oleh pernyataan yang tidak mengembalikan baris.
Penerapan
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
Berlaku untuk
Fill(DataTable, IDataReader)
- Sumber:
- DataAdapter.cs
- Sumber:
- DataAdapter.cs
- 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
- dataReader
- IDataReader
Instans IDataReader.
Mengembalikan
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
Berlaku untuk
Fill(DataTable[], IDataReader, Int32, Int32)
- Sumber:
- DataAdapter.cs
- Sumber:
- DataAdapter.cs
- 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
- dataReader
- IDataReader
Instans IDataReader.
- startRecord
- Int32
Indeks berbasis nol dari rekaman awal.
- maxRecords
- Int32
Bilangan bulat yang menunjukkan jumlah maksimum rekaman.
Mengembalikan
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
Berlaku untuk
Fill(DataSet, String, IDataReader, Int32, Int32)
- Sumber:
- DataAdapter.cs
- Sumber:
- DataAdapter.cs
- Sumber:
- DataAdapter.cs
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
- 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
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.