IDataAdapter Arabirim

Tanım

Bir nesnenin DataAdapter uygulamasına izin verir ve bir veri kaynağını doldurmak, güncelleştirmek ve güncelleştirmek için kullanılan bir DataSet dizi yöntemi ve eşleme eylemiyle ilgili özellikleri temsil eder.

IDbDataAdapter örnekler metin komutlarına (Transact-SQL gibi) sahip ilişkisel veritabanları olan (veya benzeyen) veri kaynaklarına yöneliktir; örnekler ise IDataAdapter her tür veri kaynağını kullanabilir.

public interface class IDataAdapter
public interface IDataAdapter
type IDataAdapter = interface
Public Interface IDataAdapter
Türetilmiş

Örnekler

Aşağıdaki örnek, SqlCommandveritabanından kayıtları seçmek için türetilmiş , SqlDataAdapterve SqlConnectionsınıflarını kullanır. Doldurulan DataSet daha sonra döndürülür. Bunu yapmak için yöntemi bir başlatılan DataSet, bir 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

arabirimi, IDataAdapter devralan bir sınıfın bir veri kaynağı ile arasındaki köprüyü temsil eden bir DataAdapter sınıfı uygulamasına DataSetolanak tanır. DataAdapter sınıfları hakkında daha fazla bilgi için bkz. DataAdapter'dan DataSet doldurma.

Uygulama doğrudan arabiriminin IDataAdapter bir örneğini oluşturmaz, ancak devralan IDataAdapterbir sınıfın örneğini uygular.

Devralan IDataAdapter sınıfların devralınan üyeleri uygulaması gerekir ve genellikle sağlayıcıya özgü işlevler eklemek için ek üyeler tanımlarlar. Örneğin, IDataAdapter arabirimi parametre olarak alan bir FillDataSet yöntemi tanımlar. Buna karşılık, OleDbDataAdapter sınıfı yöntemini devralır Fill 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ığı artırmak 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 tekdüzen ön ek verilir. Örneğin, Sql ad alanında System.Data.SqlClient sınıfının ön ekidirSqlDataAdapter.

Arabiriminden IDataAdapter 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 deyimini kullanarak PrvDataAdapter sınıfının yeni bir örneğini başlatır.
PrvDataAdapter(string selectCommandText, string selectConnectionString) SQL SELECT deyimini ve bağlantı dizesi kullanarak PrvDataAdapter sınıfının yeni bir örneğini başlatır.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) SQL SELECT deyimini ve PrvConnection nesnesini kullanarak PrvDataAdapter sınıfının yeni bir örneğini başlatır.

Özellikler

MissingMappingAction

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

MissingSchemaAction

Eksik kaynak tabloların, sütunların ve ilişkilerinin veri kümesi şemasına eklenip eklenmeyeceğini, yoksayılıp eklenmediğini veya hatanın neden olup olmadığını gösterir veya belirtir.

TableMappings

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

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.

FillSchema(DataSet, SchemaType)

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

GetFillParameters()

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

Update(DataSet)

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

Şunlara uygulanır