OleDbDataAdapter Kelas

Definisi

Ruang nama:

System.Data.OleDb

Rakitan:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v8.0.0

Sumber:

OleDbDataAdapter.cs

Mewakili sekumpulan perintah data dan koneksi database yang digunakan untuk mengisi DataSet dan memperbarui sumber data.

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable

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

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

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Warisan

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OleDbDataAdapter

Penerapan

IDataAdapter IDbDataAdapter ICloneable

Contoh

Contoh berikut menggunakan OleDbCommand, OleDbDataAdapter dan OleDbConnection, untuk memilih rekaman dari sumber data Access, 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 SQL SELECT.

public static OleDbDataAdapter CreateDataAdapter(string selectCommand,
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter(selectCommand, connection);

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the Insert, Update and Delete commands.
    adapter.InsertCommand = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)");

    adapter.UpdateCommand = new OleDbCommand(
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?");

    adapter.DeleteCommand = new OleDbCommand(
        "DELETE FROM Customers WHERE CustomerID = ?");

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}

Public Function CreateDataAdapter(ByVal selectCommand As String, _
    ByVal connection As OleDbConnection) As OleDbDataAdapter

    Dim adapter As OleDbDataAdapter = _
        New OleDbDataAdapter(selectCommand, connection)

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey

    ' Create the commands.
    adapter.InsertCommand = New OleDbCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
         "VALUES (?, ?)")

    adapter.UpdateCommand = New OleDbCommand( _
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?")

    adapter.DeleteCommand = New OleDbCommand( _
        "DELETE FROM Customers WHERE CustomerID = ?")

    ' Create the parameters.
    adapter.InsertCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.InsertCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.UpdateCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.UpdateCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")
    adapter.UpdateCommand.Parameters.Add( _
        "@oldCustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    adapter.DeleteCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    Return adapter
End Function

Keterangan

berfungsi OleDbDataAdapter sebagai jembatan antara DataSet sumber data dan untuk mengambil dan menyimpan data. OleDbDataAdapter menyediakan jembatan ini dengan menggunakan Fill untuk memuat data dari sumber data ke dalam DataSet, dan menggunakan Update untuk mengirim perubahan yang DataSet dibuat di belakang ke sumber data.

OleDbDataAdapter Ketika mengisi DataSet, itu akan membuat tabel dan kolom yang sesuai 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 OleDbDataAdapter skema DataSetbuat , termasuk informasi kunci primer, sebelum mengisinya dengan data menggunakan FillSchema. Untuk informasi selengkapnya, lihat Menambahkan Batasan yang Ada ke Himpunan Data.

Perhatikan bahwa beberapa penyedia OLE DB, termasuk penyedia MSDataShape, tidak mengembalikan tabel dasar atau informasi kunci utama. Oleh karena itu, OleDbDataAdapter tidak dapat mengatur properti dengan benar pada apa pun yang PrimaryKey dibuat DataTable. Dalam kasus ini, Anda harus secara eksplisit menentukan kunci primer untuk tabel di DataSet.

juga OleDbDataAdapter mencakup SelectCommandproperti , InsertCommand, DeleteCommand, UpdateCommand, dan TableMappings untuk memfasilitasi pemuatan dan pembaruan data.

Saat Anda membuat instans OleDbDataAdapter, properti diatur ke nilai awalnya. Untuk daftar nilai-nilai ini, lihat OleDbDataAdapter konstruktor.

Konstruktor

OleDbDataAdapter()	Menginisialisasi instans baru kelas OleDbDataAdapter.
OleDbDataAdapter(OleDbCommand)	Menginisialisasi instans OleDbDataAdapter baru kelas dengan yang ditentukan OleDbCommand sebagai SelectCommand properti .
OleDbDataAdapter(String, OleDbConnection)	Menginisialisasi instans OleDbDataAdapter baru kelas dengan SelectCommand.
OleDbDataAdapter(String, String)	Menginisialisasi instans OleDbDataAdapter baru kelas dengan SelectCommand.

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 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 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 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 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()	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, Object, String)	Menambahkan atau menyegarkan baris di DataSet agar sesuai dengan baris di ADO Recordset atau Record objek menggunakan objek , ADO, dan nama tabel sumber yang ditentukan DataSet.
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, Object)	Menambahkan atau merefresh baris dalam untuk DataTable mencocokkan baris di ADO Recordset atau Record objek menggunakan objek yang ditentukan DataTable dan ADO.
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 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 yang 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. Oleh karena itu, peristiwa terjadi.
RowUpdating	Terjadi selama Update(DataSet) sebelum perintah dijalankan terhadap sumber data. Upaya untuk memperbarui dilakukan. Oleh karena itu, peristiwa terjadi.

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