IDbDataAdapter Gränssnitt
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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) |