IDbDataAdapter Antarmuka

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Mewakili sekumpulan properti terkait perintah yang digunakan untuk mengisi DataSet dan memperbarui sumber data, dan diimplementasikan oleh penyedia data .NET yang mengakses database relasional.

public interface class IDbDataAdapter : System::Data::IDataAdapter

public interface IDbDataAdapter : System.Data.IDataAdapter

type IDbDataAdapter = interface
    interface IDataAdapter

Public Interface IDbDataAdapter
Implements IDataAdapter

Turunan

System.Data.Common.DbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Penerapan

IDataAdapter

Contoh

Contoh berikut menggunakan kelas turunan, SqlCommand, SqlDataAdapter dan SqlConnection, untuk memilih rekaman dari sumber data. Yang diisi DataSet kemudian dikembalikan. Untuk mencapai hal ini, metode diteruskan sebagai inisialisasi DataSet, string koneksi, dan string kueri yang merupakan pernyataan T-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

Antarmuka IDbDataAdapter mewarisi dari IDataAdapter antarmuka dan memungkinkan objek untuk membuat DataAdapter yang dirancang untuk digunakan dengan database relasional. Antarmuka IDbDataAdapter dan, secara opsional, kelas utilitas, DbDataAdapter, memungkinkan kelas warisan untuk mengimplementasikan kelas DataAdapter, yang mewakili jembatan antara sumber data dan DataSet. Untuk informasi selengkapnya tentang kelas DataAdapter, lihat Mengisi Himpunan Data dari DataAdapter. Untuk informasi selengkapnya tentang menerapkan penyedia data .NET Framework, lihat Menerapkan Penyedia Data .NET Framework.

Aplikasi tidak membuat instans antarmuka secara IDbDataAdapter langsung, tetapi membuat instans kelas yang mewarisi IDbDataAdapter dan DbDataAdapter.

Kelas yang mewarisi IDbDataAdapter harus menerapkan anggota yang diwariskan, dan biasanya menentukan anggota tambahan untuk menambahkan fungsionalitas khusus penyedia. Misalnya, IDbDataAdapter antarmuka mendefinisikan SelectCommand properti , dan DbDataAdapter antarmuka mendefinisikan Fill metode yang mengambil DataTable sebagai parameter. Pada gilirannya OleDbDataAdapter , kelas mewarisi SelectCommand properti dan Fill metode , dan juga menentukan dua kelebihan tambahan metode Fill yang mengambil objek ADO Recordset sebagai parameter.

Catatan Bagi Implementer

Untuk mempromosikan konsistensi di antara penyedia data .NET Framework, beri nama kelas pewarisan dalam formulir Prv DataAdapter di mana Prv adalah awalan seragam yang diberikan kepada semua kelas dalam namespace layanan penyedia data .NET Framework tertentu. Misalnya, Sql adalah awalan SqlDataAdapter kelas di System.Data.SqlClient namespace layanan.

Saat Mewarisi dari IDbDataAdapter antarmuka, Anda harus mengimplementasikan konstruktor berikut:

Item	Deskripsi
PrvDataAdapter()	Menginisialisasi instans baru kelas PrvDataAdapter.
PrvDataAdapter(PrvCommand selectCommand)	Menginisialisasi instans baru kelas PrvDataAdapter dengan pernyataan SQL SELECT yang ditentukan.
PrvDataAdapter(string selectCommandText, string selectConnectionString)	Menginisialisasi instans baru kelas PrvDataAdapter dengan pernyataan SQL SELECT dan string koneksi.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection)	Menginisialisasi instans baru kelas PrvDataAdapter dengan pernyataan SQL SELECT dan objek PrvConnection.

Properti

DeleteCommand	Mendapatkan atau mengatur pernyataan SQL untuk menghapus rekaman dari himpunan data.
InsertCommand	Mendapatkan atau mengatur pernyataan SQL yang digunakan untuk menyisipkan rekaman baru ke dalam sumber data.
MissingMappingAction	Menunjukkan atau menentukan apakah tabel atau kolom sumber yang tidak dipetakan diteruskan dengan nama sumbernya untuk difilter atau untuk memunculkan kesalahan. (Diperoleh dari IDataAdapter)
MissingSchemaAction	Menunjukkan atau menentukan apakah tabel sumber, kolom, dan hubungannya hilang ditambahkan ke skema himpunan data, diabaikan, atau menyebabkan kesalahan dimunculkan. (Diperoleh dari IDataAdapter)
SelectCommand	Mendapatkan atau mengatur pernyataan SQL yang digunakan untuk memilih rekaman di sumber data.
TableMappings	Mendapatkan koleksi yang menunjukkan bagaimana tabel sumber dipetakan ke tabel himpunan data. (Diperoleh dari IDataAdapter)
UpdateCommand	Mendapatkan atau mengatur pernyataan SQL yang digunakan untuk memperbarui rekaman di sumber data.

Metode

Fill(DataSet)	Menambahkan atau memperbarui baris di DataSet untuk mencocokkan baris di sumber data menggunakan DataSet nama, dan membuat DataTable bernama "Tabel". (Diperoleh dari IDataAdapter)
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 IDataAdapter)
GetFillParameters()	Mendapatkan parameter yang ditetapkan oleh pengguna saat menjalankan pernyataan SQL SELECT. (Diperoleh dari IDataAdapter)
Update(DataSet)	Memanggil pernyataan INSERT, UPDATE, atau DELETE masing-masing untuk setiap baris yang disisipkan, diperbarui, atau dihapus dalam yang ditentukan DataSet dari DataTable "Tabel" bernama. (Diperoleh dari IDataAdapter)