IDbDataAdapter Gränssnitt

Definition

Representerar en uppsättning kommandorelaterade egenskaper som används för att fylla i DataSet och uppdatera en datakälla och implementeras av .NET dataprovidrar som har åtkomst till relationsdatabaser.

public interface class IDbDataAdapter : System::Data::IDataAdapter
public interface IDbDataAdapter : System.Data.IDataAdapter
type IDbDataAdapter = interface
    interface IDataAdapter
Public Interface IDbDataAdapter
Implements IDataAdapter
Härledda
Implementeringar

Exempel

I följande exempel används de härledda klasserna , SqlCommandSqlDataAdapter och SqlConnection, för att välja poster från en datakälla. Fyllnad DataSet returneras sedan. För att åstadkomma detta skickas metoden en initierad DataSet, en reťazec pripojenia och en frågesträng som är en Transact-SQL SELECT-instruktion.

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

Kommentarer

Gränssnittet IDbDataAdapter ärver från IDataAdapter gränssnittet och gör att ett objekt kan skapa en DataAdapter som är utformad för användning med en relationsdatabas. Gränssnittet IDbDataAdapter och, om du vill, verktygsklassen , DbDataAdaptertillåter att en ärvande klass implementerar en DataAdapter-klass, som representerar bryggan mellan en datakälla och en DataSet. Mer information om DataAdapter-klasser finns i Fylla i en datauppsättning från en DataAdapter. Mer information om hur du implementerar .NET Framework-dataprovidrar finns i Implementing a .NET Framework Data Provider.

Ett program skapar inte en instans av IDbDataAdapter gränssnittet direkt, men skapar en instans av en klass som ärver IDbDataAdapter och DbDataAdapter.

Klasser som ärver IDbDataAdapter måste implementera de ärvda medlemmarna och vanligtvis definiera ytterligare medlemmar för att lägga till providerspecifika funktioner. Gränssnittet definierar SelectCommand till exempel IDbDataAdapter egenskapen och DbDataAdapter gränssnittet definierar en Fill metod som tar en DataTable som parameter. Klassen ärver SelectCommand i sin tur OleDbDataAdapter egenskapen och Fill metoden och definierar även två ytterligare överlagringar av metoden Fill som tar ett ADO Recordset-objekt som en parameter.

Anteckningar till implementerare

Om du vill främja konsekvens mellan .NET Framework-dataprovidrar namnger du ärvningsklassen i formuläret Prv DataAdapter där Prv är det enhetliga prefixet som ges till alla klasser i en specifik .NET Framework-dataproviderns namnområde. Är till exempel Sql prefixet för SqlDataAdapter klassen i System.Data.SqlClient namnområdet.

När du ärver från IDbDataAdapter gränssnittet bör du implementera följande konstruktorer:

Artikel Beskrivning
PrvDataAdapter() Initierar en ny instans av klassen PrvDataAdapter.
PrvDataAdapter(PrvCommand selectCommand) Initierar en ny instans av klassen PrvDataAdapter med den angivna SQL SELECT-instruktionen.
PrvDataAdapter(string selectCommandText, string selectConnectionString) Initierar en ny instans av klassen PrvDataAdapter med en SQL SELECT-instruktion och en reťazec pripojenia.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Initierar en ny instans av klassen PrvDataAdapter med en SQL SELECT-instruktion och ett PrvConnection-objekt.

Egenskaper

Name Description
DeleteCommand

Hämtar eller anger en SQL-instruktion för att ta bort poster från datauppsättningen.

InsertCommand

Hämtar eller anger en SQL-instruktion som används för att infoga nya poster i datakällan.

MissingMappingAction

Anger eller anger om omappade källtabeller eller kolumner skickas med sina källnamn för att filtreras eller för att generera ett fel.

(Ärvd från IDataAdapter)
MissingSchemaAction

Anger eller anger om saknade källtabeller, kolumner och deras relationer läggs till i datauppsättningsschemat, ignoreras eller orsakar ett fel.

(Ärvd från IDataAdapter)
SelectCommand

Hämtar eller anger en SQL-instruktion som används för att välja poster i datakällan.

TableMappings

Hämtar en samling som anger hur en källtabell mappas till en datamängdstabell.

(Ärvd från IDataAdapter)
UpdateCommand

Hämtar eller anger en SQL-instruktion som används för att uppdatera poster i datakällan.

Metoder

Name Description
Fill(DataSet)

Lägger till eller uppdaterar rader i DataSet för att matcha dem i datakällan med hjälp av DataSet namnet och skapar en DataTable med namnet "Table".

(Ärvd från IDataAdapter)
FillSchema(DataSet, SchemaType)

Lägger till en DataTable "tabell" i den angivna DataSet och konfigurerar schemat så att det matchar det i datakällan baserat på den angivna SchemaType.

(Ärvd från IDataAdapter)
GetFillParameters()

Hämtar de parametrar som anges av användaren när du kör en SQL SELECT-instruktion.

(Ärvd från IDataAdapter)
Update(DataSet)

Anropar respektive INSERT-, UPDATE- eller DELETE-instruktioner för varje infogad, uppdaterad eller borttagen rad i den angivna DataSet från en DataTable med namnet "Table".

(Ärvd från IDataAdapter)

Gäller för