IDbDataAdapter Interfaz

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Representa un conjunto de propiedades relacionadas con comandos que se utilizan para rellenar DataSet y actualizar un origen de datos, y la implementan los proveedores de datos de .NET que tienen acceso a bases de datos relacionales.

public interface class IDbDataAdapter : System::Data::IDataAdapter

public interface IDbDataAdapter : System.Data.IDataAdapter

type IDbDataAdapter = interface
    interface IDataAdapter

Public Interface IDbDataAdapter
Implements IDataAdapter

Derivado

System.Data.Common.DbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Implementaciones

IDataAdapter

Ejemplos

En el ejemplo siguiente se usan las clases derivadas, SqlCommand, SqlDataAdapter y SqlConnectionpara seleccionar registros de un origen de datos. A continuación, se devuelve el relleno DataSet . Para ello, el método se pasa a un inicializado DataSet, una 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 IDbDataAdapter interfaz hereda de la IDataAdapter interfaz y permite a un objeto crear un DataAdapter diseñado para su uso con una base de datos relacional. La IDbDataAdapter interfaz y, opcionalmente, la clase de utilidad , DbDataAdapterpermiten que una clase heredada implemente una clase DataAdapter, que representa el puente entre un origen de datos y un DataSet. Para obtener más información sobre las clases DataAdapter, vea Rellenar un conjunto de datos desde un DataAdapter. Para obtener más información sobre cómo implementar proveedores de datos de .NET Framework, consulte Implementación de un proveedor de datos de .NET Framework.

Una aplicación no crea una instancia de la IDbDataAdapter interfaz directamente, sino que crea una instancia de una clase que hereda IDbDataAdapter y DbDataAdapter.

Las clases que heredan IDbDataAdapter deben implementar los miembros heredados y normalmente definir miembros adicionales para agregar funcionalidad específica del proveedor. Por ejemplo, la IDbDataAdapter interfaz define la SelectCommand propiedad y la DbDataAdapter interfaz define un Fill método que toma como DataTable parámetro . A su vez, la OleDbDataAdapter clase hereda la SelectCommand propiedad y 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 con el formato 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 IDbDataAdapter 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 con la instrucción SELECT de SQL especificada.
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.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection)	Inicializa una nueva instancia de la clase PrvDataAdapter con una instrucción SELECT de SQL y un objeto PrvConnection.

Propiedades

DeleteCommand	Obtiene o establece una instrucción SQL para eliminar registros del conjunto de datos.
InsertCommand	Obtiene o establece una instrucción SQL utilizada para insertar nuevos registros en el origen de datos.
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. (Heredado de IDataAdapter)
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. (Heredado de IDataAdapter)
SelectCommand	Obtiene o establece una instrucción SQL utilizada para seleccionar registros en el origen de datos.
TableMappings	Obtiene una colección que indica cómo se asigna una tabla de origen a una tabla de conjunto de datos. (Heredado de IDataAdapter)
UpdateCommand	Obtiene o establece una instrucción SQL utilizada para actualizar registros en el origen 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". (Heredado de IDataAdapter)
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. (Heredado de IDataAdapter)
GetFillParameters()	Obtiene los parámetros establecidos por el usuario al ejecutar una instrucción SELECT de SQL. (Heredado de IDataAdapter)
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". (Heredado de IDataAdapter)