SqlDataAdapter Kelas

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.8.6

Mewakili sekumpulan perintah data dan koneksi database yang digunakan untuk mengisi DataSet dan memperbarui database SQL Server. Kelas ini tidak dapat diwariskan.

public ref class SqlDataAdapter sealed : System::Data::Common::DbDataAdapter

public sealed class SqlDataAdapter : System.Data.Common.DbDataAdapter

type SqlDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable

Public NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter

Warisan

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

SqlDataAdapter

Penerapan

IDataAdapter IDbDataAdapter ICloneable

Contoh

Contoh berikut menggunakan SqlCommand, , SqlDataAdapterdan SqlConnection untuk memilih rekaman dari database dan mengisi DataSet dengan baris yang dipilih. Yang diisi DataSet kemudian dikembalikan. Untuk mencapai hal ini, metode diteruskan sebagai inisialisasi DataSet, string koneksi, dan string kueri yang merupakan pernyataan T-SQL SELECT.

private static DataSet SelectRows(DataSet dataset,
    string connectionString,string queryString)
{
    using (SqlConnection connection =
        new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter();
        adapter.SelectCommand = new SqlCommand(
            queryString, connection);
        adapter.Fill(dataset);
        return dataset;
    }
}

Public Function SelectRows( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New SqlConnection(connectionString)
        Dim adapter As New SqlDataAdapter()
        adapter.SelectCommand = New SqlCommand( _
            queryString, connection)
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function

Keterangan

SqlDataAdapter, berfungsi sebagai jembatan antara dan DataSet SQL Server untuk mengambil dan menyimpan data. SqlDataAdapter menyediakan jembatan ini dengan memetakan Fill, yang mengubah data dalam DataSet agar sesuai dengan data di sumber data, dan Update, yang mengubah data dalam sumber data agar sesuai dengan data di DataSet, menggunakan pernyataan Transact-SQL yang sesuai dengan sumber data. Pembaruan dilakukan berdasarkan baris demi baris. Untuk setiap baris yang disisipkan, dimodifikasi, dan dihapus, Update metode menentukan jenis perubahan yang telah dilakukan di atasnya (Insert, Update, atau Delete). Bergantung pada jenis perubahan, Inserttemplat perintah , , Updateatau Delete dijalankan untuk menyebarkan baris yang dimodifikasi ke sumber data. SqlDataAdapter Saat mengisi DataSet, itu membuat tabel dan kolom yang diperlukan untuk data yang dikembalikan jika belum ada. Namun, informasi kunci primer tidak disertakan dalam skema yang dibuat secara implisit kecuali MissingSchemaAction properti diatur ke AddWithKey. Anda mungkin juga memiliki SqlDataAdapter skema DataSetbuat , termasuk informasi kunci primer, sebelum mengisinya dengan data menggunakan FillSchema. Untuk informasi selengkapnya, lihat Menambahkan Batasan yang Ada ke Himpunan Data.

SqlDataAdapterdigunakan bersama dengan SqlConnection dan SqlCommand untuk meningkatkan performa saat menyambungkan ke database SQL Server.

Catatan

Jika Anda menggunakan prosedur tersimpan SQL Server untuk mengedit atau menghapus data menggunakan DataAdapter, pastikan bahwa Anda tidak menggunakan SET NOCOUNT ON dalam definisi prosedur tersimpan. Ini menyebabkan jumlah baris yang terpengaruh dikembalikan menjadi nol, yang ditafsirkan DataAdapter sebagai konflik konkurensi. Dalam hal ini, DBConcurrencyException akan dilemparkan.

juga SqlDataAdapter mencakup SelectCommandproperti , , InsertCommandDeleteCommand, UpdateCommand, dan TableMappings untuk memfasilitasi pemuatan dan pembaruan data.

Saat instans SqlDataAdapter dibuat, properti baca/tulis diatur ke nilai awal. Untuk daftar nilai-nilai ini, lihat SqlDataAdapter konstruktor.

InsertCommand, DeleteCommand, dan UpdateCommand adalah templat generik yang secara otomatis diisi dengan nilai individual dari setiap baris yang dimodifikasi melalui mekanisme parameter.

Untuk setiap kolom yang Anda sebarkan ke sumber data pada Update, parameter harus ditambahkan ke InsertCommand, , UpdateCommandatau DeleteCommand. Properti SourceColumnDbParameter objek harus diatur ke nama kolom. Pengaturan ini menunjukkan bahwa nilai parameter tidak diatur secara manual, tetapi diambil dari kolom tertentu di baris yang saat ini diproses.

Catatan

InvalidOperationException Akan terjadi jika Fill metode dipanggil dan tabel berisi jenis yang ditentukan pengguna yang tidak tersedia di komputer klien. Untuk informasi selengkapnya, lihat Jenis User-Defined CLR.

Konstruktor

SqlDataAdapter()	Menginisialisasi instans baru kelas SqlDataAdapter.
SqlDataAdapter(SqlCommand)	Menginisialisasi instans SqlDataAdapter baru kelas dengan yang ditentukan SqlCommand sebagai SelectCommand properti .
SqlDataAdapter(String, SqlConnection)	Menginisialisasi instans SqlDataAdapter baru kelas dengan SelectCommand objek dan SqlConnection .
SqlDataAdapter(String, String)	Menginisialisasi instans SqlDataAdapter baru kelas dengan SelectCommand dan string koneksi.

Bidang

DefaultSourceTableName

Nama default yang DataAdapter digunakan oleh objek untuk pemetaan tabel. (Diperoleh dari DbDataAdapter)

Properti

AcceptChangesDuringFill	Mendapatkan atau menetapkan nilai yang menunjukkan apakah AcceptChanges() dipanggil pada DataRow setelah ditambahkan ke DataTable selama salah satu operasi Isian . (Diperoleh dari DataAdapter)
AcceptChangesDuringUpdate	Mendapatkan atau mengatur apakah AcceptChanges() dipanggil selama Update(DataSet). (Diperoleh dari DataAdapter)
CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
ContinueUpdateOnError	Mendapatkan atau menetapkan nilai yang menentukan apakah akan menghasilkan pengecualian saat kesalahan ditemui selama pembaruan baris. (Diperoleh dari DataAdapter)
DeleteCommand	Mendapatkan atau mengatur pernyataan Transact-SQL atau prosedur tersimpan untuk menghapus rekaman dari himpunan data.
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
FillCommandBehavior	Mendapatkan atau mengatur perilaku perintah yang digunakan untuk mengisi adaptor data. (Diperoleh dari DbDataAdapter)
FillLoadOption	Mendapatkan atau mengatur LoadOption yang menentukan bagaimana adaptor mengisi DataTable dari DbDataReader. (Diperoleh dari DataAdapter)
InsertCommand	Mendapatkan atau mengatur pernyataan Transact-SQL atau prosedur tersimpan untuk menyisipkan rekaman baru ke dalam sumber data.
MissingMappingAction	Menentukan tindakan yang harus diambil saat data masuk tidak memiliki tabel atau kolom yang cocok. (Diperoleh dari DataAdapter)
MissingSchemaAction	Menentukan tindakan yang akan diambil ketika skema yang DataSet ada tidak cocok dengan data masuk. (Diperoleh dari DataAdapter)
ReturnProviderSpecificTypes	Mendapatkan atau mengatur apakah Fill metode harus mengembalikan nilai khusus penyedia atau nilai umum yang mematuhi CLS. (Diperoleh dari DataAdapter)
SelectCommand	Mendapatkan atau mengatur pernyataan Transact-SQL atau prosedur tersimpan yang digunakan untuk memilih rekaman di sumber data.
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
TableMappings	Mendapatkan koleksi yang menyediakan pemetaan utama antara tabel sumber dan DataTable. (Diperoleh dari DataAdapter)
UpdateBatchSize	Mendapatkan atau mengatur jumlah baris yang diproses di setiap perjalanan pulang-pergi ke server.
UpdateCommand	Mendapatkan atau mengatur pernyataan Transact-SQL atau prosedur tersimpan yang digunakan untuk memperbarui rekaman di sumber data.

Metode

AddToBatch(IDbCommand)	IDbCommand Menambahkan ke batch saat ini. (Diperoleh dari DbDataAdapter)
ClearBatch()	Menghapus semua IDbCommand objek dari batch. (Diperoleh dari DbDataAdapter)
CloneInternals()	Membuat salinan instans ini dari DataAdapter. (Diperoleh dari DataAdapter)
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Menginisialisasi instans baru kelas RowUpdatedEventArgs. (Diperoleh dari DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Menginisialisasi instans baru kelas RowUpdatingEventArgs. (Diperoleh dari DbDataAdapter)
CreateTableMappings()	Membuat baru DataTableMappingCollection. (Diperoleh dari DataAdapter)
Dispose()	Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh DbDataAdapter dan secara opsional merilis sumber daya terkelola. (Diperoleh dari DbDataAdapter)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
ExecuteBatch()	Menjalankan batch saat ini. (Diperoleh dari DbDataAdapter)
Fill(DataSet)	Menambahkan atau me-refresh baris di DataSet. (Diperoleh dari DbDataAdapter)
Fill(DataSet, Int32, Int32, String)	Menambahkan atau menyegarkan baris dalam rentang tertentu di DataSet agar sesuai dengan baris di sumber data menggunakan DataSet nama dan DataTable . (Diperoleh dari DbDataAdapter)
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Menambahkan atau merefresh baris dalam rentang tertentu di DataSet agar sesuai dengan baris di sumber data menggunakan DataSet nama tabel sumber, string perintah, dan perilaku perintah. (Diperoleh dari DbDataAdapter)
Fill(DataSet, String)	Menambahkan atau merefresh baris di DataSet agar sesuai dengan baris di sumber data menggunakan DataSet nama dan DataTable . (Diperoleh dari DbDataAdapter)
Fill(DataSet, String, IDataReader, Int32, Int32)	Menambahkan atau merefresh baris dalam rentang tertentu agar DataSet sesuai dengan baris di sumber data menggunakan DataSetnama , DataTable, dan IDataReader . (Diperoleh dari DbDataAdapter)
Fill(DataTable)	Menambahkan atau merefresh baris dalam rentang tertentu di DataSet agar sesuai dengan baris di sumber data menggunakan DataTable nama . (Diperoleh dari DbDataAdapter)
Fill(DataTable, IDataReader)	Menambahkan atau menyegarkan baris dalam DataTable agar sesuai dengan baris di sumber data menggunakan nama dan IDataReader yang ditentukanDataTable. (Diperoleh dari DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Menambahkan atau me-refresh baris dalam DataTable agar sesuai dengan baris di sumber data menggunakan , IDbCommand dan CommandBehavioryang ditentukanDataTable. (Diperoleh dari DbDataAdapter)
Fill(DataTable[], IDataReader, Int32, Int32)	Menambahkan atau menyegarkan baris dalam rentang tertentu dalam kumpulan DataTable objek agar sesuai dengan baris di sumber data. (Diperoleh dari DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	Menambahkan atau menyegarkan baris dalam rentang tertentu di DataSet agar sesuai dengan baris di sumber data menggunakan DataSet nama dan DataTable . (Diperoleh dari DbDataAdapter)
Fill(Int32, Int32, DataTable[])	Menambahkan atau menyegarkan baris dalam satu atau beberapa DataTable objek agar sesuai dengan yang ada di sumber data mulai dari rekaman yang ditentukan dan mengambil hingga jumlah rekaman maksimum yang ditentukan. (Diperoleh dari DbDataAdapter)
FillSchema(DataSet, SchemaType)	DataTable Menambahkan "Tabel" bernama ke yang ditentukan DataSet dan mengonfigurasi skema agar sesuai dengan yang ada di sumber data berdasarkan yang ditentukanSchemaType. (Diperoleh dari DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	DataTable Menambahkan ke yang ditentukan DataSet dan mengonfigurasi skema agar sesuai dengan yang ada di sumber data berdasarkan yang ditentukanSchemaType. (Diperoleh dari DbDataAdapter)
FillSchema(DataSet, SchemaType, String)	DataTable Menambahkan ke yang ditentukan DataSet dan mengonfigurasi skema agar sesuai dengan yang ada di sumber data berdasarkan dan DataTableyang ditentukanSchemaType. (Diperoleh dari DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)	DataTable Menambahkan ke yang ditentukanDataSet. (Diperoleh dari DataAdapter)
FillSchema(DataTable, SchemaType)	Mengonfigurasi skema yang ditentukan DataTable berdasarkan yang ditentukan SchemaType. (Diperoleh dari DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)	DataTable Menambahkan ke yang ditentukanDataSet. (Diperoleh dari DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Mengonfigurasi skema yang ditentukan DataTable berdasarkan , string perintah, dan CommandBehavior nilai yang ditentukanSchemaType. (Diperoleh dari DbDataAdapter)
GetBatchedParameter(Int32, Int32)	Mengembalikan IDataParameter dari salah satu perintah dalam batch saat ini. (Diperoleh dari DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)	Mengembalikan informasi tentang upaya pembaruan individual dalam pembaruan batch yang lebih besar. (Diperoleh dari DbDataAdapter)
GetFillParameters()	Mendapatkan parameter yang ditetapkan oleh pengguna saat menjalankan pernyataan SQL SELECT. (Diperoleh dari DbDataAdapter)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
HasTableMappings()	Menunjukkan apakah DataTableMappingCollection telah dibuat. (Diperoleh dari DataAdapter)
InitializeBatching()	Menginisialisasi batching untuk DbDataAdapter. (Diperoleh dari DbDataAdapter)
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
OnFillError(FillErrorEventArgs)	Memunculkan kejadian FillError. (Diperoleh dari DbDataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	RowUpdated Meningkatkan peristiwa penyedia data .NET. (Diperoleh dari DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	RowUpdating Meningkatkan peristiwa penyedia data .NET. (Diperoleh dari DbDataAdapter)
ResetFillLoadOption()	Mengatur ulang FillLoadOption ke status defaultnya dan menyebabkan Fill(DataSet) untuk menghormati AcceptChangesDuringFill. (Diperoleh dari DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Menentukan apakah AcceptChangesDuringFill properti harus dipertahankan. (Diperoleh dari DataAdapter)
ShouldSerializeFillLoadOption()	Menentukan apakah FillLoadOption properti harus dipertahankan. (Diperoleh dari DataAdapter)
ShouldSerializeTableMappings()	Menentukan apakah ada satu atau beberapa DataTableMapping objek dan objek tersebut harus dipertahankan. (Diperoleh dari DataAdapter)
TerminateBatching()	Mengakhiri batching untuk DbDataAdapter. (Diperoleh dari DbDataAdapter)
ToString()	Mengembalikan yang String berisi nama Component, jika ada. Metode ini tidak boleh ditimpa. (Diperoleh dari Component)
Update(DataRow[])	Updates nilai dalam database dengan menjalankan pernyataan INSERT, UPDATE, atau DELETE masing-masing untuk setiap baris yang disisipkan, diperbarui, atau dihapus dalam array yang ditentukan di DataSet. (Diperoleh dari DbDataAdapter)
Update(DataRow[], DataTableMapping)	Updates nilai dalam database dengan menjalankan pernyataan INSERT, UPDATE, atau DELETE masing-masing untuk setiap baris yang disisipkan, diperbarui, atau dihapus dalam array DataRow objek yang ditentukan. (Diperoleh dari DbDataAdapter)
Update(DataSet)	Updates nilai dalam database dengan menjalankan pernyataan INSERT, UPDATE, atau DELETE masing-masing untuk setiap baris yang disisipkan, diperbarui, atau dihapus dalam yang ditentukanDataSet. (Diperoleh dari DbDataAdapter)
Update(DataSet, String)	Updates nilai dalam database dengan menjalankan pernyataan INSERT, UPDATE, atau DELETE masing-masing untuk setiap baris yang disisipkan, diperbarui, atau dihapus dengan DataSet nama yang ditentukanDataTable. (Diperoleh dari DbDataAdapter)
Update(DataTable)	Updates nilai dalam database dengan menjalankan pernyataan INSERT, UPDATE, atau DELETE masing-masing untuk setiap baris yang disisipkan, diperbarui, atau dihapus dalam yang ditentukanDataTable. (Diperoleh dari DbDataAdapter)

Acara

Disposed	Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component)
FillError	Dikembalikan ketika terjadi kesalahan selama operasi pengisian. (Diperoleh dari DbDataAdapter)
RowUpdated	Terjadi selama Update(DataSet) setelah perintah dijalankan terhadap sumber data. Upaya untuk memperbarui dilakukan, sehingga peristiwa diaktifkan.
RowUpdating	Terjadi selama Update(DataSet) sebelum perintah dijalankan terhadap sumber data. Upaya untuk memperbarui dilakukan, sehingga peristiwa diaktifkan.

Implementasi Antarmuka Eksplisit

ICloneable.Clone()	Untuk deskripsi anggota ini, lihat Clone().
IDbDataAdapter.DeleteCommand	Untuk deskripsi anggota ini, lihat DeleteCommand.
IDbDataAdapter.InsertCommand	Untuk deskripsi anggota ini, lihat InsertCommand.
IDbDataAdapter.SelectCommand	Untuk deskripsi anggota ini, lihat SelectCommand.
IDbDataAdapter.UpdateCommand	Untuk deskripsi anggota ini, lihat UpdateCommand.

Lihat juga

• DataAdapters dan DataReaders
• Memanipulasi Data (ADO.NET)
• Ringkasan ADO.NET