IDataAdapter Arabirim

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Data.Common.dll

Kaynak:

IDataAdapter.cs

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

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

public interface class IDataAdapter

public interface IDataAdapter

type IDataAdapter = interface

Public Interface IDataAdapter

Türetilmiş

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

Örnekler

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

Bir uygulama doğrudan arabirimin 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 arabirim 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ı Prv DataAdapter biçiminde 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 SqlDataAdapter sınıfının ön ekidirSystem.Data.SqlClient.

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

Name	Description
MissingMappingAction	Eşlenmemiş kaynak tablo 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 eklendiğini, yoksayıldığını veya hatanın neden olup olmadığını belirtir veya belirtir.
TableMappings	Kaynak tablonun bir veri kümesi tablosuna nasıl eşlendiğini gösteren bir koleksiyon alır.

Yöntemler

Name	Description
Fill(DataSet)	öğesinin içindeki satırları DataSet , adı kullanarak DataSet veri kaynağındakilerle eşleşecek şekilde ekler veya güncelleştirir ve adlandırılmış bir DataTable "Tablo" oluşturur.
FillSchema(DataSet, SchemaType)	Belirtilen DataTable öğesine adlandırılmış bir DataSet "Tablo" ekler ve şemayı belirtilen SchemaTypetemelinde veri kaynağındakiyle eşleşecek şekilde yapılandırır.
GetFillParameters()	SQL SELECT deyimi yürütülürken kullanıcı tarafından ayarlanan parametreleri alır.
Update(DataSet)	Belirtilen DataSet "Tablo" adlı bir satırdan DataTable eklenen, güncelleştirilen veya silinen her satır için ilgili INSERT, UPDATE veya DELETE deyimlerini çağırır.