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.

Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.

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 DataSet yang diinisialisasi, 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.

Note

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.

Note

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. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
SqlDataAdapter(SqlCommand)	Menginisialisasi instans SqlDataAdapter baru kelas dengan yang ditentukan SqlCommand sebagai SelectCommand properti . Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
SqlDataAdapter(String, SqlConnection)	Menginisialisasi instans SqlDataAdapter baru kelas dengan SelectCommand objek dan SqlConnection . Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
SqlDataAdapter(String, String)	Menginisialisasi instans SqlDataAdapter baru kelas dengan SelectCommand string koneksi dan . Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.

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	Mendapatkan IContainer 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. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke Componentini. (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. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
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. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Site	Mengambil atau menetapkan 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. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
UpdateCommand	Mendapatkan atau mengatur pernyataan Transact-SQL atau prosedur tersimpan yang digunakan untuk memperbarui rekaman di sumber data. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.

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 digunakan oleh Component. (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 SchemaType nilai yang ditentukanCommandBehavior. (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 MarshalByRefObject saat ini. (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 objek DataRow 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 di DataSet dengan nama DataTable yang ditentukan. (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 DataSetyang ditentukan. (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 DataTableyang ditentukan. (Diperoleh dari DbDataAdapter)

Acara

Nama	Deskripsi
Disposed	Terjadi ketika komponen dibuang oleh panggilan ke metode Dispose(). (Diperoleh dari Component)
RowUpdated	Terjadi selama Update(DataSet) setelah perintah dijalankan terhadap sumber data. Upaya untuk memperbarui dilakukan, sehingga peristiwa diaktifkan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
RowUpdating	Terjadi selama Update(DataSet) sebelum perintah dijalankan terhadap sumber data. Upaya untuk memperbarui dilakukan, sehingga peristiwa diaktifkan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
ICloneable.Clone()	Untuk deskripsi anggota ini, lihat Clone(). Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
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. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
IDbDataAdapter.InsertCommand	Untuk deskripsi anggota ini, lihat InsertCommand. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
IDbDataAdapter.SelectCommand	Untuk deskripsi anggota ini, lihat SelectCommand. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
IDbDataAdapter.UpdateCommand	Untuk deskripsi anggota ini, lihat UpdateCommand. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.

Lihat juga

• DataAdapters dan DataReaders
• Memanipulasi Data (ADO.NET)
• Gambaran Umum ADO.NET