IDataAdapter Rozhraní

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

Zdroj:

IDataAdapter.cs

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

IDbDataAdapter Instance jsou určené pro zdroje dat, které jsou relačními databázemi (nebo podobně) 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é

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

Příklady

Následující příklad používá odvozené třídy , SqlCommandSqlDataAdaptera SqlConnection, k výběru záznamů z databáze. Vyplněný DataSet se pak vrátí. K tomu se metodě předá inicializovaná DataSet, připojovací řetězec a řetězec dotazu, který je příkazem Transact-SQL SELECT.

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 dědění třídy implementovat DataAdapter třídy, která představuje most mezi zdrojem dat a DataSet. Další informace o třídách DataAdapter naleznete v tématu Naplnění datové sady z objektu DataAdapter.

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

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

Poznámky pro implementátory

Chcete-li zvýšit konzistenci mezi zprostředkovateli dat .NET Framework, pojmenujte dědění třídy ve formuláři Prv DataAdapter, kde Prv je jednotná předpona udělená všem třídám v konkrétním oboru názvů zprostředkovatele dat .NET Framework. Například Sql je předpona SqlDataAdapter třídy v System.Data.SqlClient oboru názvů.

Při dědění z IDataAdapter rozhraní byste měli implementovat následující konstruktory:

Položka	Popis
PrvDataAdapter()	Inicializuje novou instanci PrvDataAdapter třídy.
PrvDataAdapter(PrvCommand selectCommand)	Inicializuje novou instanci Třídy PrvDataAdapter pomocí zadaného příkazu SQL SELECT.
PrvDataAdapter(string selectCommandText, string selectConnectionString)	Inicializuje novou instanci Třídy PrvDataAdapter 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

Name	Description
MissingMappingAction	Označuje nebo určuje, jestli se nemapované zdrojové tabulky nebo sloupce předávají s jejich názvy zdrojů, aby bylo možné filtrovat nebo vyvolat chybu.
MissingSchemaAction	Označuje nebo určuje, jestli se chybějící zdrojové tabulky, sloupce a jejich relace přidají do schématu datové sady, budou ignorovány nebo způsobí vyvolání chyby.
TableMappings	Získá kolekci, která označuje, jak je zdrojová tabulka mapována na tabulku datové sady.

Metody

Name	Description
Fill(DataSet)	Přidá nebo aktualizuje řádky odpovídající DataSet řádkům ve zdroji dat pomocí DataSet názvu a vytvoří pojmenovanou DataTable tabulku.
FillSchema(DataSet, SchemaType)	Přidá do zadaného pole pojmenovanou DataTable tabulku a nakonfiguruje schéma tak, aby odpovídalo schématu ve zdroji dat na základě zadaného DataSet.SchemaType
GetFillParameters()	Získá parametry nastavené uživatelem při provádě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 řádku z pojmenované DataTable tabulky.