IDataAdapter Interfaz

Definición

Permite que un objeto implemente un DataAdapter. Representa un conjunto de métodos y propiedades relacionadas con acciones de asignación que se usan para rellenar y actualizar un DataSet y actualizar un origen de datos.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.

Las instancias IDbDataAdapter son para los orígenes de datos que son (o se asemejan a) bases de datos relacionales con comandos textuales (como Transact-SQL), mientras que las instancias IDataAdapter pueden usar cualquier tipo de origen de datos.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
Derivado

Ejemplos

En el ejemplo siguiente se usan las clases derivadas, SqlCommand, SqlDataAdaptery SqlConnection, para seleccionar registros de una base de datos.The following example uses the derived classes, SqlCommand, SqlDataAdapter, and SqlConnection, to select records from a database. A continuación, se devuelve el DataSet relleno.The filled DataSet is then returned. Para ello, se pasa al método un DataSetinicializado, una cadena de conexión y una cadena de consulta que es una instrucción SELECT de Transact-SQL.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

Comentarios

La interfaz de IDataAdapter permite que una clase heredada implemente una clase DataAdapter, que representa el puente entre un origen de datos y un DataSet.The IDataAdapter interface allows an inheriting class to implement a DataAdapter class, which represents the bridge between a data source and a DataSet. Para obtener más información sobre las clases DataAdapter, vea rellenar un conjunto de datos desde un objeto DataAdapter.For more information about DataAdapter classes, see Populating a DataSet from a DataAdapter.

Una aplicación no crea una instancia de la interfaz IDataAdapter directamente, pero implementa una instancia de una clase que hereda IDataAdapter.An application does not create an instance of the IDataAdapter interface directly, but implements an instance of a class that inherits IDataAdapter.

Las clases que heredan IDataAdapter deben implementar los miembros heredados y, por lo general, definen miembros adicionales para agregar funcionalidad específica del proveedor.Classes that inherit IDataAdapter must implement the inherited members, and they typically define additional members to add provider-specific functionality. Por ejemplo, la interfaz de IDataAdapter define un método de Fill que toma un DataSet como parámetro.For example, the IDataAdapter interface defines a Fill method that takes a DataSet as a parameter. A su vez, la clase OleDbDataAdapter hereda el método Fill y también define dos sobrecargas adicionales del método Fill que toman un objeto de conjunto de registros ADO como parámetro.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.

Notas a los implementadores

Para promover la coherencia entre .NET Framework proveedores de datos, asigne a la clase heredada el formato Prv DataAdapter, donde Prv es el prefijo uniforme dado a todas las clases de un espacio de nombres de proveedor de datos de .NET Framework específico.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. Por ejemplo, Sql es el prefijo de la clase SqlDataAdapter en el espacio de nombres System.Data.SqlClient.For example, Sql is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

Cuando herede de la interfaz IDataAdapter, debe implementar los siguientes constructores:When you inherit from the IDataAdapter interface, you should implement the following constructors:

ElementoItem DescripciónDescription
PrvDataAdapter()PrvDataAdapter() Inicializa una nueva instancia de la clase PrvDataAdapter.Initializes a new instance of the PrvDataAdapter class.
PrvDataAdapter (PrvCommand selectCommand)PrvDataAdapter(PrvCommand selectCommand) Inicializa una nueva instancia de la clase PrvDataAdapter con la instrucción SELECT de SQL especificada.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) Inicializa una nueva instancia de la clase PrvDataAdapter con una instrucción SELECT de SQL y una cadena de conexión.Initializes a new instance of the PrvDataAdapter class by using an SQL SELECT statement and a connection string.
PrvDataAdapter (cadena selectCommandText, PrvConnection selectConnection)PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Inicializa una nueva instancia de la clase PrvDataAdapter con una instrucción SELECT de SQL y un objeto PrvConnection.Initializes a new instance of the PrvDataAdapter class by using an SQL SELECT statement and a PrvConnection object.

Propiedades

MissingMappingAction

Indica o especifica si las tablas o columnas de origen no asignadas se pasan con sus nombres de origen, para que se filtren o para generar un error.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

Indica o especifica si las tablas y columnas de origen y las relaciones entre ellas que faltan se agregan al esquema del conjunto de datos, se omiten o hacen que se genere un error.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

Indica cómo se asigna una tabla de origen a una tabla de conjuntos de datos.Indicates how a source table is mapped to a dataset table.

Métodos

Fill(DataSet)

Agrega filas a la clase DataSet o las actualiza para hacerlas coincidir con las del origen de datos mediante el nombre de DataSet y crea un objeto DataTable denominado "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)

Agrega una DataTable denominada "Table" para el DataSet especificado y configura el esquema para que coincida con el origen de datos basado en el SchemaType especificado.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()

Obtiene los parámetros establecidos por el usuario al ejecutar una instrucción SELECT de SQL.Gets the parameters set by the user when executing an SQL SELECT statement.

Update(DataSet)

Llama a las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en la clase DataSet especificada a partir de un objeto DataTable denominado "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".

Se aplica a