IDataAdapter.Fill(DataSet) Metode

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Menambahkan atau memperbarui baris di DataSet agar sesuai dengan baris di sumber data menggunakan DataSet nama, dan membuat DataTable "Tabel" bernama.

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

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

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

Public 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.

Keterangan

Fill mengambil 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.

IDataAdapter Jika menemukan kolom duplikat saat mengisi DataTable, kolom menghasilkan nama untuk kolom berturut-turut, menggunakan pola "columnname1", "columnname2", "columnname3", dan sebagainya. Jika data masuk berisi kolom yang tidak disebutkan namanya, data tersebut dimasukkan DataSet sesuai dengan pola "Column1", "Column2", dan sebagainya. Ketika beberapa tataan hasil ditambahkan ke DataSet, setiap tataan hasil dimasukkan ke dalam tabel terpisah. Tataan hasil tambahan dinamai dengan menambahkan nilai integral ke nama tabel yang ditentukan (misalnya, "Tabel", "Table1", "Table2", dan sebagainya). Aplikasi harus berhati-hati saat menggunakan nama kolom dan tabel untuk 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 berturut-turut 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 Fill dan FillSchema untuk penyedia data .NET Framework mengambil informasi skema hanya untuk hasil pertama.

Lihat juga

• FillSchema(DataSet, SchemaType)