OdbcDataAdapter Kelas

Definisi

Ruang nama:

System.Data.Odbc

Rakitan:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v9.0.0-rc.1.24431.7

Sumber:

OdbcDataAdapter.cs

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 sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

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

Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Warisan

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OdbcDataAdapter

Penerapan

IDataAdapter IDbDataAdapter ICloneable

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. OdbcDataAdapter menyediakan 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 primer, sebelum mengisinya dengan data menggunakan FillSchema. Untuk informasi selengkapnya, lihat Menambahkan Batasan yang Ada ke Himpunan Data.

Catatan

Saat Anda memanggil Fill metode pada sumber data yang tidak memiliki kolom kunci primer, OdbcDataAdapter mencoba mempromosikan kolom batasan unik ke kunci primer. 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.

Catatan

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

OdbcDataAdapter()	Menginisialisasi instans baru 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

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 setelah DataRow ditambahkan ke DataTable selama salah satu operasi Isi . (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 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 ada DataSet 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 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

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 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 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)	Menambahkan atau merefresh baris di DataSet. (Diperoleh dari DbDataAdapter)
Fill(DataSet, Int32, Int32, String)	Menambahkan atau merefresh baris dalam rentang tertentu agar DataSet 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 agar DataSet 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 agar DataSet sesuai dengan baris di sumber data menggunakan DataTable nama . (Diperoleh dari DbDataAdapter)
Fill(DataTable, IDataReader)	Menambahkan atau menyegarkan baris dalam agar DataTable 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 agar DataTable sesuai dengan baris di sumber data menggunakan , dan IDbCommandCommandBehavioryang ditentukanDataTable. (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 agar DataSet 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 SchemaType. (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 yang ditentukan SchemaType dan DataTable. (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()	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 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()	Kedaluwarsa. 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 baris 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 baris 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 operasi pembaruan setelah perintah dijalankan terhadap sumber data.
RowUpdating	Terjadi selama Update(DataSet) sebelum perintah dijalankan terhadap sumber data.

Implementasi Antarmuka Eksplisit

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