OdbcDataAdapter Kelas
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.
Mewakili sekumpulan perintah data dan koneksi ke sumber data yang digunakan untuk mengisi DataSet dan memperbarui sumber data. Kelas ini tidak dapat diwariskan.
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter
type OdbcDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneable
type OdbcDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneable
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
- Warisan
- Penerapan
Contoh
Contoh berikut menggunakan OdbcCommand, , OdbcDataAdapterdan OdbcConnection untuk memilih rekaman dan mengisi DataSet dengan baris yang dipilih.
public DataSet GetDataSetFromAdapter(
DataSet dataSet, string connectionString, string queryString)
{
using (OdbcConnection connection =
new OdbcConnection(connectionString))
{
OdbcDataAdapter adapter =
new OdbcDataAdapter(queryString, connection);
// Open the connection and fill the DataSet.
try
{
connection.Open();
adapter.Fill(dataSet);
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
// The connection is automatically closed when the
// code exits the using block.
}
return dataSet;
}
Public Function GetDataSetFromAdapter( _
ByVal dataSet As DataSet, ByVal connectionString As String, _
ByVal queryString As String) As DataSet
Using connection As New OdbcConnection(connectionString)
Dim adapter As New OdbcDataAdapter(queryString, connection)
' Open the connection and fill the DataSet.
Try
connection.Open()
adapter.Fill(dataSet)
Catch ex As Exception
Console.WriteLine(ex.Message)
End Try
' The connection is automatically closed when the
' code exits the Using block.
End Using
Return dataSet
End Function
Keterangan
berfungsi OdbcDataAdapter sebagai jembatan antara DataSet sumber data dan untuk mengambil dan menyimpan data. menyediakan OdbcDataAdapter jembatan ini dengan menggunakan Fill untuk memuat data dari sumber data ke dalam DataSet, dan menggunakan Update untuk mengirim perubahan yang dibuat di bagian DataSet belakang ke sumber data.
OdbcDataAdapter 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 OdbcDataAdapter skema DataSetbuat , termasuk informasi kunci utama, sebelum mengisinya dengan data menggunakan FillSchema. Untuk informasi selengkapnya, lihat Menambahkan Batasan yang Ada ke Himpunan Data.
Nota
Saat Anda memanggil Fill metode pada sumber data yang tidak memiliki kolom kunci utama, OdbcDataAdapter mencoba mempromosikan kolom batasan unik ke kunci utama. Dalam prosesnya, OdbcDataAdapter menandai batasan unik sebagai tidak dapat diubah ke null. Perilaku ini berfungsi kecuali ada nilai null di kolom batasan unik. Jika ada nilai null, Fill metode gagal dengan pelanggaran batasan. Untuk menghindari situasi ini, jangan izinkan nilai null di kolom batasan unik.
Nota
Karena keterbatasan driver ODBC asli, hanya satu DataTable yang pernah dikembalikan ketika Anda memanggil FillSchema. Ini berlaku bahkan ketika menjalankan pernyataan batch SQL dari mana beberapa DataTable objek akan diharapkan.
juga OdbcDataAdapter mencakup SelectCommandproperti , , InsertCommandDeleteCommand, UpdateCommand, dan TableMappings untuk memfasilitasi pemuatan dan pembaruan data.
Konstruktor
| Nama | Deskripsi |
|---|---|
| OdbcDataAdapter() |
Menginisialisasi instans baru dari kelas OdbcDataAdapter. |
| OdbcDataAdapter(OdbcCommand) |
Menginisialisasi instans OdbcDataAdapter baru kelas dengan pernyataan SQL SELECT yang ditentukan. |
| OdbcDataAdapter(String, OdbcConnection) |
Menginisialisasi instans OdbcDataAdapter baru kelas dengan pernyataan SQL SELECT dan OdbcConnection. |
| OdbcDataAdapter(String, String) |
Menginisialisasi instans OdbcDataAdapter baru kelas dengan pernyataan SQL SELECT dan string koneksi. |
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 SQL atau prosedur tersimpan yang digunakan untuk menghapus rekaman di sumber 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 SQL atau prosedur tersimpan yang digunakan 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 |
| SelectCommand |
Mendapatkan atau mengatur pernyataan 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 menetapkan nilai yang mengaktifkan atau menonaktifkan dukungan pemrosesan batch, dan menentukan jumlah perintah yang dapat dijalankan dalam batch. (Diperoleh dari DbDataAdapter) |
| UpdateCommand |
Mendapatkan atau mengatur pernyataan 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.
Kedaluwarsa.
Kedaluwarsa.
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, 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(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, IDataReader) |
Menambahkan atau merefresh 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 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() |
Kedaluwarsa.
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() |
Kedaluwarsa.
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) |
| OnFillError(FillErrorEventArgs) |
Menaikkan FillError acara. (Diperoleh dari DbDataAdapter) |
| OnRowUpdated(RowUpdatedEventArgs) |
|
| OnRowUpdating(RowUpdatingEventArgs) |
|
| 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) |
| FillError |
Dikembalikan ketika kesalahan terjadi selama operasi pengisian. (Diperoleh dari DbDataAdapter) |
| RowUpdated |
Terjadi selama operasi pembaruan setelah perintah dijalankan terhadap sumber data. |
| RowUpdating |
Terjadi selama Update(DataSet) sebelum perintah dijalankan terhadap sumber data. |
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. |