IDataAdapter Interface

Definitie

Naamruimte:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Hiermee kan een object een DataAdapter implementeren en een set methoden vertegenwoordigen en actiegerelateerde eigenschappen toewijzen die worden gebruikt om een DataSet gegevensbron in te vullen en bij te werken.

IDbDataAdapter exemplaren zijn voor gegevensbronnen die relationele databases zijn (of lijken) met tekstopdrachten (zoals Transact-SQL), terwijl IDataAdapter exemplaren elk type gegevensbron kunnen gebruiken.

public interface class IDataAdapter
public interface IDataAdapter
type IDataAdapter = interface
Public Interface IDataAdapter
Afgeleid

Voorbeelden

In het volgende voorbeeld worden de afgeleide klassen, SqlCommand, en SqlDataAdapter, SqlConnectiongebruikt om records in een database te selecteren. De opgevulde DataSet waarde wordt vervolgens geretourneerd. Hiervoor wordt de methode doorgegeven aan een geïnitialiseerde DataSet, een verbindingsreeks en een queryreeks die een Transact-SQL SELECT-instructie is.

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

Opmerkingen

Met de IDataAdapter interface kan een overnemende klasse een DataAdapter-klasse implementeren, die de brug tussen een gegevensbron en een DataSet. Zie Een DataSet invullen vanuit een DataAdapter voor meer informatie over DataAdapter-klassen.

Een toepassing maakt geen exemplaar van de IDataAdapter interface rechtstreeks, maar implementeert een exemplaar van een klasse die wordt overgenomen IDataAdapter.

Klassen die de overgenomen leden overnemen IDataAdapter , moeten de overgenomen leden implementeren en ze definiëren doorgaans extra leden om providerspecifieke functionaliteit toe te voegen. De IDataAdapter interface definieert bijvoorbeeld een Fill methode die een DataSet parameter gebruikt. Op zijn beurt neemt de OleDbDataAdapter klasse de Fill methode over en definieert ook twee extra overbelastingen van de Fill methode die een ADO Recordset-object als parameter neemt.

Notities voor uitvoerders

Als u consistentie tussen .NET Framework-gegevensproviders wilt bevorderen, geeft u de overnemende klasse een naam in de vorm Prv DataAdapter, waarbij Prv het uniforme voorvoegsel is dat wordt gegeven aan alle klassen in een specifieke .NET Framework-naamruimte voor de gegevensprovider. Is bijvoorbeeld Sql het voorvoegsel van de SqlDataAdapter klasse in de System.Data.SqlClient naamruimte.

Wanneer u de IDataAdapter interface over neemt, moet u de volgende constructors implementeren:

Artikel Beschrijving
PrvDataAdapter() Initialiseert een nieuw exemplaar van de klasse PrvDataAdapter.
PrvDataAdapter(PrvCommand selectCommand) Initialiseert een nieuw exemplaar van de klasse PrvDataAdapter met behulp van de opgegeven SQL SELECT-instructie.
PrvDataAdapter(tekenreeks selectCommandText, tekenreeks selectConnectionString) Initialiseert een nieuw exemplaar van de klasse PrvDataAdapter met behulp van een SQL SELECT-instructie en een verbindingsreeks.
PrvDataAdapter(tekenreeks selectCommandText, PrvConnection selectConnection) Initialiseert een nieuw exemplaar van de klasse PrvDataAdapter met behulp van een SQL SELECT-instructie en een PrvConnection-object.

Eigenschappen

Name Description
MissingMappingAction

Geeft aan of geeft aan of niet-toegewezen brontabellen of -kolommen worden doorgegeven met hun bronnamen om te worden gefilterd of om een fout te genereren.
MissingSchemaAction

Hiermee wordt aangegeven of aangegeven of er ontbrekende brontabellen, kolommen en de bijbehorende relaties worden toegevoegd aan het gegevenssetschema, genegeerd of een fout wordt gegenereerd.
TableMappings

Hiermee haalt u een verzameling op die aangeeft hoe een brontabel wordt toegewezen aan een gegevenssettabel.

Methoden

Name Description
Fill(DataSet)

Hiermee worden rijen toegevoegd of bijgewerkt die DataSet overeenkomen met de rijen in de gegevensbron met behulp van de DataSet naam en wordt een DataTable benoemde tabel gemaakt.
FillSchema(DataSet, SchemaType)

Voegt een DataTable benoemde tabel toe aan de opgegeven DataSet en configureert het schema zodat het overeenkomt met het schema in de gegevensbron op basis van de opgegeven SchemaType.
GetFillParameters()

Hiermee haalt u de parameters op die door de gebruiker zijn ingesteld bij het uitvoeren van een SQL SELECT-instructie.
Update(DataSet)

Roept de respectieve INSERT-, UPDATE- of DELETE-instructies aan voor elke ingevoegde, bijgewerkte of verwijderde rij in de opgegeven DataSet uit een DataTable benoemde tabel.

Van toepassing op