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á k výběru záznamů ze zdroje dat odvozené třídy SqlCommand, SqlDataAdapter a SqlConnection. Vyplněný DataSet se pak vrátí. Za tímto účelem se metodě předá inicializovaný DataSetřetězec , 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í 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ě i třída DbDataAdapternástrojů , umožňují dědící třídě implementovat třídu DataAdapter, která představuje most mezi zdrojem dat a DataSet. Další informace o třídách DataAdapter najdete v tématu Naplnění datové sady z objektu DataAdapter. Další informace o implementaci zprostředkovatelů dat rozhraní .NET Framework najdete 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á přebírá DataTable jako parametr . Třída zase OleDbDataAdapter dědí SelectCommand vlastnost a metodu Fill a také definuje dvě další přetížení Fill metody, která přebírá 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í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ředponou 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 PrvDataAdapter třídy pomocí příkazu SQL SELECT a připojovacího řetězce.
PrvDataAdapter(string 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, zda se mají nemapované zdrojové tabulky nebo sloupce předávat se svými názvy zdrojů, aby bylo možné je 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, ignorují 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

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)