IDataAdapter Rozhraní

Definice

Umožňuje objektu implementovat metodu DataAdapter a představuje sadu metod a mapování vlastností souvisejících s akcemi, které se používají k vyplnění a aktualizaci DataSet a aktualizaci zdroje dat.Allows an object to implement a DataAdapter, and represents a set of methods and mapping action-related properties that are used to fill and update a DataSet and update a data source.

instance IDbDataAdapter jsou pro zdroje dat, které jsou (nebo podobně) relační databáze s textovými příkazy (například Transact-SQL), zatímco IDataAdapter instance můžou použít jakýkoliv typ zdroje dat.IDbDataAdapter instances are for data sources that are (or resemble) relational databases with textual commands (like Transact-SQL), while IDataAdapter instances could can use any type of data source.

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

Příklady

Následující příklad používá odvozené třídy, SqlCommand, SqlDataAdaptera SqlConnectionk výběru záznamů z databáze.The following example uses the derived classes, SqlCommand, SqlDataAdapter, and SqlConnection, to select records from a database. Vrátí se vyplněný DataSet.The filled DataSet is then returned. K tomu je metoda předána inicializovaný DataSet, připojovací řetězec a řetězec dotazu, který je příkazem jazyka Transact-SQL SELECT.To do this, the method is passed an initialized DataSet, a connection string, and a query string that is a Transact-SQL SELECT statement.

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 třídu DataAdapter, která představuje most mezi zdrojem dat a DataSet.The IDataAdapter interface allows an inheriting class to implement a DataAdapter class, which represents the bridge between a data source and a DataSet. Další informace o třídách DataAdapter naleznete v tématu naplnění datové sady z DataAdapter.For more information about DataAdapter classes, see Populating a DataSet from a DataAdapter.

Aplikace nevytváří instanci rozhraní IDataAdapter přímo, ale implementuje instanci třídy, která dědí IDataAdapter.An application does not create an instance of the IDataAdapter interface directly, but implements an instance of a class that inherits 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 poskytovatele.Classes that inherit IDataAdapter must implement the inherited members, and they typically define additional members to add provider-specific functionality. Například rozhraní IDataAdapter definuje metodu Fill, která přebírá DataSet jako parametr.For example, the IDataAdapter interface defines a Fill method that takes a DataSet as a parameter. Třída OleDbDataAdapter dědí metodu Fill a také definuje dvě další přetížení metody Fill, která přijímají objekt ADO Recordset jako parametr.In turn, the OleDbDataAdapter class inherits the Fill method and also defines two additional overloads of the Fill method that take an ADO Recordset object as a parameter.

Poznámky pro implementátory

Chcete-li zvýšit konzistenci mezi .NET Framework zprostředkovateli dat, pojmenujte třídu dědění ve formuláři Prv DataAdapter, kde Prv je jednotná předpona poskytnutá všem třídám v konkrétním oboru názvů .NET Framework zprostředkovatele dat.To promote consistency among .NET Framework data providers, name the inheriting class in the form Prv DataAdapter where Prv is the uniform prefix given to all classes in a specific .NET Framework data provider namespace. Například Sql je předpona SqlDataAdapter třídy v oboru názvů System.Data.SqlClient.For example, Sql is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

Při dědění z rozhraní IDataAdapter byste měli implementovat následující konstruktory:When you inherit from the IDataAdapter interface, you should implement the following constructors:

PoložkaItem PopisDescription
PrvDataAdapter()PrvDataAdapter() Inicializuje novou instanci třídy PrvDataAdapter.Initializes a new instance of the PrvDataAdapter class.
PrvDataAdapter (PrvCommand selectCommand)PrvDataAdapter(PrvCommand selectCommand) Inicializuje novou instanci třídy PrvDataAdapter pomocí zadaného příkazu SQL SELECT.Initializes a new instance of the PrvDataAdapter class by using the specified SQL SELECT statement.
PrvDataAdapter (String selectCommandText; String selectConnectionString)PrvDataAdapter(string selectCommandText, string selectConnectionString) Inicializuje novou instanci třídy PrvDataAdapter pomocí příkazu jazyka SQL SELECT a připojovacího řetězce.Initializes a new instance of the PrvDataAdapter class by using an SQL SELECT statement and a connection string.
PrvDataAdapter (String selectCommandText, PrvConnection selectConnection)PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Inicializuje novou instanci třídy PrvDataAdapter pomocí příkazu jazyka SQL SELECT a objektu PrvConnection.Initializes a new instance of the PrvDataAdapter class by using an SQL SELECT statement and a PrvConnection object.

Vlastnosti

MissingMappingAction

Označuje nebo určuje, zda jsou nemapované zdrojové tabulky nebo sloupce předány se svými názvy zdroje, aby je bylo možné filtrovat nebo vyvolat chybu.Indicates or specifies whether unmapped source tables or columns are passed with their source names in order to be filtered or to raise an error.

MissingSchemaAction

Označuje nebo určuje, zda jsou chybějící zdrojové tabulky, sloupce a jejich vztahy přidány do schématu datové sady, ignorovány nebo způsobují chybu, která má být vyvolána.Indicates or specifies whether missing source tables, columns, and their relationships are added to the dataset schema, ignored, or cause an error to be raised.

TableMappings

Označuje způsob mapování zdrojové tabulky na tabulku dataset.Indicates how a source table is mapped to a dataset table.

Metody

Fill(DataSet)

Přidá nebo aktualizuje řádky v DataSet tak, aby odpovídaly hodnotám ve zdroji dat pomocí DataSet názvu, a vytvoří DataTable s názvem "Table".Adds or updates rows in the DataSet to match those in the data source using the DataSet name, and creates a DataTable named "Table".

FillSchema(DataSet, SchemaType)

Přidá DataTable s názvem Table do zadaného DataSet a nakonfiguruje schéma tak, aby odpovídalo ve zdroji dat na základě zadaného SchemaType.Adds a DataTable named "Table" to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

GetFillParameters()

Získá parametry nastavené uživatelem při provádění příkazu SELECT jazyka SQL.Gets the parameters set by the user when executing an SQL SELECT statement.

Update(DataSet)

Zavolá příslušné příkazy INSERT, UPDATE nebo DELETE pro všechny vložené, aktualizované nebo odstraněné řádky v zadaném DataSet z DataTable s názvem "Table".Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet from a DataTable named "Table".

Platí pro