IDbDataAdapter Rozhraní

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

Zdroj:

IDbDataAdapter.cs

Představuje sadu vlastností souvisejících s příkazy, které se používají k vyplnění DataSet a aktualizaci zdroje dat a implementují zprostředkovatelé dat .NET, kteří přistupují k relačním databázím.

public interface class IDbDataAdapter : System::Data::IDataAdapter

public interface IDbDataAdapter : System.Data.IDataAdapter

type IDbDataAdapter = interface
    interface IDataAdapter

Public Interface IDbDataAdapter
Implements IDataAdapter

Odvozené

System.Data.Common.DbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Implementuje

IDataAdapter

Příklady

Následující příklad používá odvozené třídy SqlCommandSqlDataAdapter a SqlConnection, k výběru záznamů ze zdroje dat. Vyplněný DataSet se pak vrátí. K tomu se metoda předá inicializovanému DataSet, připojovacímu řetězci a řetězci dotazu, který je Transact-SQL příkazu 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í IDbDataAdapter dědí z IDataAdapter rozhraní a umožňuje objektu vytvořit Objekt DataAdapter navržený pro použití s relační databází. Rozhraní IDbDataAdapter a volitelně, utility třída, DbDataAdapter, povolit 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. Další informace o implementaci zprostředkovatelů dat rozhraní .NET Framework naleznete v tématu Implementace zprostředkovatele dat rozhraní .NET Framework.

Aplikace nevytvoří instanci IDbDataAdapter rozhraní přímo, ale vytvoří instanci třídy, která dědí IDbDataAdapter a DbDataAdapter.

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

Poznámky pro implementátory

Chcete-li zvýšit konzistenci mezi zprostředkovateli dat rozhraní .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 rozhraní .NET Framework. Například Sql je předpona SqlDataAdapter třídy v System.Data.SqlClient oboru názvů.

Při dědění z IDbDataAdapter 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 PrvDataAdapter třídy pomocí zadaného příkazu SQL SELECT.
PrvDataAdapter(string selectCommandText, string selectConnectionString)	Inicializuje novou instanci Třídy PrvDataAdapter příkazem SQL SELECT a připojovacím řetězcem.
PrvDataAdapter(řetězec selectCommandText, PrvConnection selectConnection)	Inicializuje novou instanci PrvDataAdapter třídy pomocí příkazu SQL SELECT a PrvConnection objektu.

Vlastnosti

Name	Description
DeleteCommand	Získá nebo nastaví příkaz SQL pro odstranění záznamů z datové sady.
InsertCommand	Získá nebo nastaví příkaz SQL použitý k vložení nových záznamů do zdroje dat.
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. (Zděděno od IDataAdapter)
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. (Zděděno od IDataAdapter)
SelectCommand	Získá nebo nastaví příkaz SQL použitý k výběru záznamů ve zdroji dat.
TableMappings	Získá kolekci, která označuje, jak je zdrojová tabulka mapována na tabulku datové sady. (Zděděno od IDataAdapter)
UpdateCommand	Získá nebo nastaví příkaz SQL sloužící k aktualizaci záznamů ve zdroji dat.

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. (Zděděno od IDataAdapter)
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 SchemaType.DataSet (Zděděno od IDataAdapter)
GetFillParameters()	Získá parametry nastavené uživatelem při provádění příkazu SQL SELECT. (Zděděno od IDataAdapter)
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. (Zděděno od IDataAdapter)