IDataAdapter Antarmuka

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Memungkinkan objek untuk mengimplementasikan DataAdapter, dan mewakili sekumpulan metode dan pemetaan properti terkait tindakan yang digunakan untuk mengisi dan memperbarui DataSet dan memperbarui sumber data.

IDbDataAdapter instans adalah untuk sumber data yang (atau menyerupai) database relasional dengan perintah tekstual (seperti Transact-SQL), sementara IDataAdapter instans dapat menggunakan semua jenis sumber data.

public interface class IDataAdapter

public interface IDataAdapter

type IDataAdapter = interface

Public Interface IDataAdapter

Turunan

System.Data.Common.DataAdapter

System.Data.Common.DbDataAdapter

System.Data.IDbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Contoh

Contoh berikut menggunakan kelas turunan, , SqlCommand, SqlDataAdapterdan SqlConnection, untuk memilih rekaman dari database. Yang diisi DataSet kemudian dikembalikan. Untuk melakukan 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 IDataAdapter 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.

Aplikasi tidak membuat instans IDataAdapter antarmuka secara langsung, tetapi mengimplementasikan instans kelas yang mewarisi IDataAdapter.

Kelas yang mewarisi IDataAdapter harus mengimplementasikan anggota yang diwariskan, dan mereka biasanya menentukan anggota tambahan untuk menambahkan fungsionalitas khusus penyedia. Misalnya, IDataAdapter antarmuka mendefinisikan Fill metode yang mengambil DataSet sebagai parameter. Pada gilirannya OleDbDataAdapter , kelas mewarisi Fill metode dan juga mendefinisikan 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 IDataAdapter antarmuka, Anda harus mengimplementasikan konstruktor berikut:

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

Properti

MissingMappingAction	Menunjukkan atau menentukan apakah tabel atau kolom sumber yang tidak dipetakan diteruskan dengan nama sumbernya untuk difilter atau untuk memunculkan kesalahan.
MissingSchemaAction	Menunjukkan atau menentukan apakah tabel sumber, kolom, dan hubungannya hilang ditambahkan ke skema himpunan data, diabaikan, atau menyebabkan kesalahan dimunculkan.
TableMappings	Mendapatkan koleksi yang menunjukkan bagaimana tabel sumber dipetakan ke tabel himpunan data.

Metode

Fill(DataSet)	Menambahkan atau memperbarui baris di DataSet untuk mencocokkan baris di sumber data menggunakan DataSet nama, dan membuat DataTable bernama "Tabel".
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.
GetFillParameters()	Mendapatkan parameter yang ditetapkan oleh pengguna saat menjalankan pernyataan SQL SELECT.
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.