IDbDataAdapter Rozhraní

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

Představuje sadu vlastností souvisejících s příkazy, které se používají k vyplnění DataSet a aktualizaci zdroje dat a je implementována zprostředkovateli 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 SqlConnectionk výběru záznamů ze zdroje dat. Vyplněná DataSet hodnota se pak vrátí. K tomu se metodě předá inicializovaný DataSetpř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í IDbDataAdapter dědí z IDataAdapter rozhraní a umožňuje objektu vytvořit objekt DataAdapter určený pro použití s relační databází. Rozhraní IDbDataAdapter a volitelně i obslužná třída DbDataAdapter, umožňují dědící třídě implementovat třídu DataAdapter, která představuje most mezi zdrojem dat a objektem DataSet. Další informace o třídách DataAdapter naleznete v tématu Naplnění DataSet z 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í IDbDataAdapter , musí implementovat zděděné členy a obvykle definovat další členy pro přidání funkcí specifických pro zprostředkovatele. Například IDbDataAdapter rozhraní definuje SelectCommand vlastnost a DbDataAdapter rozhraní definuje metodu Fill , která jako parametr přebírá DataTable . Třída pak OleDbDataAdapter dědí SelectCommand vlastnost a 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 IDbDataAdapter 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 se zadaným příkazem SQL SELECT.
PrvDataAdapter(řetězec selectCommandText, řetězec selectConnectionString)	Inicializuje novou instanci PrvDataAdapter třídy pomocí příkazu SELECT jazyka SQL a připojovacího řetězce.
PrvDataAdapter(řetězec selectCommandText, PrvConnection selectConnection)	Inicializuje novou instanci PrvDataAdapter třídy pomocí příkazu SQL SELECT a PrvConnection objektu.

Vlastnosti

DeleteCommand	Získá nebo nastaví příkaz SQL pro odstranění záznamů z datové sady.
InsertCommand	Získá nebo nastaví příkaz SQL sloužící k vložení nových záznamů do zdroje dat.
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. (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, ignorují nebo způsobí vyvolání chyby. (Zděděno od IDataAdapter)
SelectCommand	Získá nebo nastaví sql příkaz slouží 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

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. (Zděděno od IDataAdapter)
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. (Zděděno od IDataAdapter)
GetFillParameters()	Získá parametry nastavené uživatelem při spuště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 z pojmenovaného DataTable "Table". (Zděděno od IDataAdapter)