IDataAdapter Interfaz

  • Referencia

Definición

Espacio de nombres:
System.Data
Ensamblado:
System.Data.Common.dll
Ensamblado:
System.Data.dll
Ensamblado:
netstandard.dll

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.

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.

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. A continuación, se devuelve el relleno DataSet . Para ello, el método se pasa un inicializado DataSet, un cadena de conexión y una cadena de consulta que es una instrucción SELECT de 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

Comentarios

La IDataAdapter interfaz permite que una clase heredada implemente una clase DataAdapter, que representa el puente entre un origen de datos y .DataSet Para obtener más información sobre las clases DataAdapter, vea Rellenar un conjunto de datos desde un objeto DataAdapter.

Una aplicación no crea una instancia de la IDataAdapter interfaz directamente, sino que implementa una instancia de una clase que hereda IDataAdapter.

Las clases que heredan IDataAdapter deben implementar los miembros heredados y normalmente definen miembros adicionales para agregar funcionalidad específica del proveedor. Por ejemplo, la IDataAdapter interfaz define un Fill método que toma como DataSet parámetro . A su vez, la OleDbDataAdapter clase hereda el Fill método y también define dos sobrecargas adicionales del Fill método que toman un objeto Recordset de ADO como parámetro.

Notas a los implementadores

Para promover la coherencia entre los proveedores de datos de .NET Framework, asigne un nombre a la clase heredada en el formulario Prv DataAdapter, donde Prv es el prefijo uniforme proporcionado a todas las clases de un espacio de nombres específico del proveedor de datos de .NET Framework. Por ejemplo, Sql es el prefijo de la SqlDataAdapter clase en el System.Data.SqlClient espacio de nombres .

Al heredar de la IDataAdapter interfaz, debe implementar los siguientes constructores:

Elemento Descripción
PrvDataAdapter() Inicializa una nueva instancia de la clase PrvDataAdapter.
PrvDataAdapter(PrvCommand selectCommand) Inicializa una nueva instancia de la clase PrvDataAdapter mediante la instrucción SELECT de SQL especificada.
PrvDataAdapter(string selectCommandText, string selectConnectionString) Inicializa una nueva instancia de la clase PrvDataAdapter mediante una instrucción SELECT de SQL y un cadena de conexión.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Inicializa una nueva instancia de la clase PrvDataAdapter mediante una instrucción SELECT de SQL y un objeto PrvConnection.

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.
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.
TableMappings

Obtiene una colección que indica cómo se asigna una tabla de origen a una tabla de conjunto de datos.

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".
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.
GetFillParameters()

Obtiene los parámetros establecidos por el usuario al ejecutar una instrucción SELECT de SQL.
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".

Se aplica a