SqlDataAdapter Kelas

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.dll

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, ICloneable

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

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

Public NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter
Implements ICloneable

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 Transact-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 SQL DataSet Server dan 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 di sumber data agar sesuai dengan data di DataSet, menggunakan pernyataan Transact-SQL yang sesuai terhadap 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 Ketika 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 utama, sebelum mengisinya dengan data menggunakan FillSchema. Untuk informasi selengkapnya, lihat Menambahkan Batasan yang Ada ke Himpunan Data.

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

Nota

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, , DeleteCommanddan 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.

Nota

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

Konstruktor

Nama	Deskripsi
SqlDataAdapter()	Menginisialisasi instans baru dari 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 string koneksi dan .

Bidang

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

Properti

Nama	Deskripsi
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 sumber data.
MissingMappingAction	Menentukan tindakan yang akan diambil saat data masuk tidak memiliki tabel atau kolom yang cocok. (Diperoleh dari DataAdapter)
MissingSchemaAction	Menentukan tindakan yang harus 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 pulang pergi ke server.
UpdateCommand	Mendapatkan atau mengatur pernyataan Transact-SQL atau prosedur tersimpan yang digunakan untuk memperbarui rekaman di sumber data.

Metode

Nama	Deskripsi
AddToBatch(IDbCommand)	IDbCommand Menambahkan ke batch saat ini. (Diperoleh dari DbDataAdapter)
ClearBatch()	Menghapus semua IDbCommand objek dari batch. (Diperoleh dari DbDataAdapter)
CloneInternals()	Kedaluwarsa. 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 dari kelas RowUpdatedEventArgs. (Diperoleh dari DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Menginisialisasi instans baru dari 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 yang tidak dikelola yang DbDataAdapter digunakan oleh 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, 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, Int32, Int32, String)	Menambahkan atau merefresh baris dalam rentang tertentu di DataSet agar sesuai dengan baris di sumber data menggunakan DataSet nama dan DataTable . (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)	Menambahkan atau merefresh baris di DataSet. (Diperoleh dari DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Menambahkan atau merefresh baris dalam DataTable agar sesuai dengan baris di sumber data menggunakan DataTable, IDbCommand dan CommandBehavior. (Diperoleh dari DbDataAdapter)
Fill(DataTable)	Menambahkan atau merefresh baris dalam rentang tertentu di DataSet agar sesuai dengan baris di sumber data menggunakan DataTable nama tersebut. (Diperoleh dari DbDataAdapter)
Fill(DataTable[], IDataReader, Int32, Int32)	Menambahkan atau merefresh 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 merefresh 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 merefresh baris dalam satu atau beberapa DataTable objek agar sesuai dengan baris di sumber data yang dimulai dari rekaman yang ditentukan dan mengambil hingga jumlah maksimum rekaman yang ditentukan. (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 SchemaType. (Diperoleh dari DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)	DataTable Menambahkan ke DataSet. (Diperoleh dari DataAdapter)
FillSchema(DataSet, SchemaType, String)	DataTable Menambahkan ke yang ditentukan DataSet dan mengonfigurasi skema agar sesuai dengan yang ada di sumber data berdasarkan yang ditentukan SchemaType dan DataTable. (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 SchemaType. (Diperoleh dari DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)	DataTable Menambahkan ke DataSet. (Diperoleh dari DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Mengonfigurasi skema yang ditentukan DataTable berdasarkan string perintah, dan CommandBehavior nilai yang ditentukanSchemaType. (Diperoleh dari DbDataAdapter)
FillSchema(DataTable, SchemaType)	Mengonfigurasi skema yang ditentukan DataTable berdasarkan SchemaType. (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 Type instans 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 Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
OnRowUpdated(RowUpdatedEventArgs)	RowUpdated Meningkatkan peristiwa penyedia data .NET. (Diperoleh dari DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	RowUpdating Meningkatkan peristiwa penyedia data .NET. (Diperoleh dari DbDataAdapter)
ResetFillLoadOption()	Reset 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[], DataTableMapping)	Memperbarui 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(DataRow[])	Perbarui 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(DataSet, String)	Memperbarui nilai dalam database dengan menjalankan pernyataan INSERT, UPDATE, atau DELETE masing-masing untuk setiap baris yang disisipkan, diperbarui, atau dihapus dengan DataSet nama yang ditentukan DataTable . (Diperoleh dari DbDataAdapter)
Update(DataSet)	Perbarui nilai dalam database dengan menjalankan pernyataan INSERT, UPDATE, atau DELETE masing-masing untuk setiap baris yang disisipkan, diperbarui, atau dihapus dalam baris yang ditentukan DataSet. (Diperoleh dari DbDataAdapter)
Update(DataTable)	Perbarui nilai dalam database dengan menjalankan pernyataan INSERT, UPDATE, atau DELETE masing-masing untuk setiap baris yang disisipkan, diperbarui, atau dihapus dalam baris yang ditentukan DataTable. (Diperoleh dari DbDataAdapter)

Acara

Nama	Deskripsi
Disposed	Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component)
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

Nama	Deskripsi
ICloneable.Clone()	Untuk deskripsi anggota ini, lihat Clone().
IDataAdapter.TableMappings	Mendapatkan koleksi yang menunjukkan bagaimana tabel sumber dipetakan ke tabel himpunan data. (Diperoleh dari DataAdapter)
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)
• Gambaran Umum ADO.NET