IDbDataAdapter Arabirim

Tanım

Bir veri kaynağını doldurmak ve güncelleştirmek için kullanılan ve ilişkisel veritabanlarına DataSet erişen .NET veri sağlayıcıları tarafından uygulanan komutla ilgili özellikler kümesini temsil eder.

public interface class IDbDataAdapter : System::Data::IDataAdapter
public interface IDbDataAdapter : System.Data.IDataAdapter
type IDbDataAdapter = interface
    interface IDataAdapter
Public Interface IDbDataAdapter
Implements IDataAdapter
Türetilmiş
Uygulamalar

Örnekler

Aşağıdaki örnekte, SqlCommandbir veri kaynağından kayıtları seçmek için türetilmiş sınıflar , SqlDataAdapter ve SqlConnectionkullanılır. Doldurulan DataSet daha sonra döndürülür. Bunu başarmak için yöntemine başlatıldı DataSet, bağlantı dizesi ve Transact-SQL SELECT deyimi olan bir sorgu dizesi geçirilir.

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

Açıklamalar

Arabirim IDbDataAdapter arabirimden devralınır ve bir nesnenin IDataAdapter ilişkisel veritabanıyla kullanılmak üzere tasarlanmış bir DataAdapter oluşturmasına izin verir. IDbDataAdapter arabirimi ve isteğe bağlı olarak yardımcı programı sınıfı, DbDataAdapterdevralan bir sınıfın veri kaynağı ile arasındaki köprüyü temsil eden bir DataAdapter sınıfı uygulamasına DataSetizin verir. DataAdapter sınıfları hakkında daha fazla bilgi için bkz. DataAdapter'dan DataSet doldurma. .NET Framework veri sağlayıcıları uygulama hakkında daha fazla bilgi için bkz. .NET Framework Veri Sağlayıcısı Uygulama.

Bir uygulama doğrudan arabirimin bir örneğini IDbDataAdapter oluşturmaz, ancak ve DbDataAdapterdevralan IDbDataAdapter bir sınıfın örneğini oluşturur.

Devralan IDbDataAdapter sınıfların devralınan üyeleri uygulaması ve genellikle sağlayıcıya özgü işlevler eklemek için ek üyeler tanımlaması gerekir. Örneğin, IDbDataAdapter arabirimi özelliğini tanımlar SelectCommand ve DbDataAdapter arabirimi parametre olarak alan bir FillDataTable yöntemi tanımlar. Buna karşılık sınıfı, OleDbDataAdapter özelliğini ve Fill yöntemini devralır SelectCommand ve ayrıca bir ADO Recordset nesnesini parametre olarak alan yöntemin Fill iki ek aşırı yüklemesini tanımlar.

Uygulayanlara Notlar

.NET Framework veri sağlayıcıları arasında tutarlılığı yükseltmek için, devralan sınıfı DataAdapter biçiminde Prv adlandırın; burada Prv belirli bir .NET Framework veri sağlayıcısı ad alanında tüm sınıflara verilen tekdüzen ön ektir. Örneğin, Sql ad alanında System.Data.SqlClient sınıfının ön ekidirSqlDataAdapter.

Arabiriminden IDbDataAdapter devraldığınızda aşağıdaki oluşturucuları uygulamanız gerekir:

Öğe Açıklama
PrvDataAdapter() PrvDataAdapter sınıfının yeni bir örneğini başlatır.
PrvDataAdapter(PrvCommand selectCommand) Belirtilen SQL SELECT deyimiyle PrvDataAdapter sınıfının yeni bir örneğini başlatır.
PrvDataAdapter(string selectCommandText, string selectConnectionString) Sql SELECT deyimi ve bağlantı dizesi ile PrvDataAdapter sınıfının yeni bir örneğini başlatır.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Sql SELECT deyimi ve PrvConnection nesnesi ile PrvDataAdapter sınıfının yeni bir örneğini başlatır.

Özellikler

DeleteCommand

Veri kümesinden kayıtları silmek için bir SQL deyimi alır veya ayarlar.

InsertCommand

Veri kaynağına yeni kayıtlar eklemek için kullanılan bir SQL deyimini alır veya ayarlar.

MissingMappingAction

Filtrelenmek veya hataya neden olmak için eşlenmemiş kaynak tabloların veya sütunların kaynak adlarıyla geçirilip geçirilmeyeceğini belirtir veya belirtir.

(Devralındığı yer: IDataAdapter)
MissingSchemaAction

Eksik kaynak tabloların, sütunların ve ilişkilerinin veri kümesi şemasına eklenip eklenmeyeceğini, yoksayıldığını veya hatanın ortaya çıkarılıp çıkarılmayacağını belirtir veya belirtir.

(Devralındığı yer: IDataAdapter)
SelectCommand

Veri kaynağındaki kayıtları seçmek için kullanılan bir SQL deyimini alır veya ayarlar.

TableMappings

Kaynak tablonun bir veri kümesi tablosuna nasıl eşlendiğini gösteren bir koleksiyon alır.

(Devralındığı yer: IDataAdapter)
UpdateCommand

Veri kaynağındaki kayıtları güncelleştirmek için kullanılan bir SQL deyimini alır veya ayarlar.

Yöntemler

Fill(DataSet)

adını kullanarak DataSet veri kaynağındakilerle DataSet eşleşecek şekilde içindeki satırları ekler veya güncelleştirir ve adlandırılmış bir DataTable "Tablo" oluşturur.

(Devralındığı yer: IDataAdapter)
FillSchema(DataSet, SchemaType)

Belirtilen DataSet öğesine adlandırılmış bir DataTable "Tablo" ekler ve şemayı belirtilen SchemaTypetemelinde veri kaynağındakiyle eşleşecek şekilde yapılandırılır.

(Devralındığı yer: IDataAdapter)
GetFillParameters()

SQL SELECT deyimini yürütürken kullanıcı tarafından ayarlanan parametreleri alır.

(Devralındığı yer: IDataAdapter)
Update(DataSet)

Belirtilen adlandırılmış bir "Tablo"dan DataTable eklenenDataSet, güncelleştirilen veya silinen her satır için ilgili INSERT, UPDATE veya DELETE deyimlerini çağırır.

(Devralındığı yer: IDataAdapter)

Şunlara uygulanır