IDataAdapter Rozhraní

  • Reference

Definice

Obor názvů:
System.Data
Sestavení:
System.Data.Common.dll
Sestavení:
System.Data.dll
Sestavení:
netstandard.dll

Umožňuje objektu implementovat dataAdapter a představuje sadu metod a mapování vlastností souvisejících s akcí, které se používají k vyplnění a aktualizaci DataSet a aktualizaci zdroje dat.

IDbDataAdapter Instance jsou pro zdroje dat, které jsou (nebo se podobají) relačním databázím s textovými příkazy (například Transact-SQL), zatímco IDataAdapter instance můžou používat libovolný typ zdroje dat.

public interface class IDataAdapter
public interface IDataAdapter
type IDataAdapter = interface
Public Interface IDataAdapter
Odvozené

Příklady

Následující příklad používá k výběru záznamů z databáze odvozené třídy SqlCommand, SqlDataAdaptera SqlConnection. Vyplněná DataSet hodnota se pak vrátí. Za tímto účelem se metodě předá inicializovaný DataSetvýraz , připojovací řetězec a řetězec dotazu, který je příkazem Select jazyka Transact-SQL.

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

Poznámky

Rozhraní IDataAdapter umožňuje zděděné třídě implementovat třídu DataAdapter, která představuje most mezi zdrojem dat a DataSet. Další informace o třídách DataAdapter naleznete v tématu Naplnění DataSet z DataAdapter.

Aplikace nevytvoří instanci IDataAdapter rozhraní přímo, ale implementuje instanci třídy, která dědí IDataAdapter.

Třídy, které dědí IDataAdapter , musí implementovat zděděné členy a obvykle definují další členy pro přidání funkcí specifických pro zprostředkovatele. Rozhraní například definuje metoduFill, IDataAdapter která přijímá DataSet jako parametr . Třída pak OleDbDataAdapter dědí metodu Fill a také definuje dvě další přetížení Fill metody, která jako parametr přebírají objekt ADO Recordset.

Poznámky pro implementátory

Chcete-li zvýšit konzistenci mezi zprostředkovateli dat rozhraní .NET Framework, pojmenujte dědící třídu ve formátu Prv DataAdapter, kde Prv je jednotná předpona přidělená všem třídám v určitém oboru názvů zprostředkovatele dat rozhraní .NET Framework. Je například Sql předpona SqlDataAdapter třídy v System.Data.SqlClient oboru názvů .

Když dědíte z IDataAdapter rozhraní, měli byste implementovat následující konstruktory:

Položka Popis
PrvDataAdapter() Inicializuje novou instanci PrvDataAdapter třídy.
PrvDataAdapter(PrvCommand selectCommandCommand) Inicializuje novou instanci PrvDataAdapter třídy pomocí zadané sql select příkaz.
PrvDataAdapter(řetězec selectCommandText, řetězec selectConnectionString) Inicializuje novou instanci PrvDataAdapter třídy pomocí příkazu SQL SELECT a připojovací řetězec.
PrvDataAdapter(řetězec selectCommandText, PrvConnection selectConnection) Inicializuje novou instanci PrvDataAdapter třídy pomocí příkazu SQL SELECT a PrvConnection objektu.

Vlastnosti

MissingMappingAction

Určuje nebo určuje, jestli se předávají nenamapované zdrojové tabulky nebo sloupce s názvy jejich zdrojů, aby se vyfiltrovaly nebo aby se zobrazila chyba.
MissingSchemaAction

Označuje nebo určuje, jestli se chybějící zdrojové tabulky, sloupce a jejich relace přidají do schématu datové sady, ignorují nebo způsobí vyvolání chyby.
TableMappings

Získá kolekci, která označuje, jak je zdrojová tabulka mapována na tabulku datové sady.

Metody

Fill(DataSet)

Přidá nebo aktualizuje řádky v objektu DataSet tak, aby odpovídaly řádkům ve zdroji dat pomocí DataSet názvu, a vytvoří pojmenovanou DataTable tabulku.
FillSchema(DataSet, SchemaType)

Přidá pojmenovanou DataTable "tabulku" k zadanému DataSet a nakonfiguruje schéma tak, aby odpovídalo schématu ve zdroji dat na základě zadaného SchemaType.
GetFillParameters()

Získá parametry nastavené uživatelem při spuštění příkazu SQL SELECT.
Update(DataSet)

Volá příslušné příkazy INSERT, UPDATE nebo DELETE pro každý vložený, aktualizovaný nebo odstraněný řádek v zadaném DataSet z pojmenovaného DataTable "Table".

Platí pro