IDbDataAdapter Interfaz

Definición

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
Implementaciones

Ejemplos

En el ejemplo siguiente se usan las clases derivadas, SqlCommand, SqlDataAdapter y SqlConnection, para seleccionar registros de un origen de datos. A continuación, se devuelve el relleno DataSet . Para ello, el método se pasa 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 que un objeto cree 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 .DataSet Para obtener más información sobre las clases DataAdapter, vea Rellenar un conjunto de datos desde un objeto DataAdapter. Para obtener más información sobre la implementación de 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 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 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)

Se aplica a