IDbDataAdapter Interfaz

Definición

Espacio de nombres:

System.Data

Ensamblados:

netstandard.dll, System.Data.Common.dll

Source:

IDbDataAdapter.cs

Representa un conjunto de propiedades relacionadas con comandos que se usan para rellenar DataSet y actualizar un origen de datos y se implementa mediante proveedores de datos de .NET que acceden 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 SqlConnection, para 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 Objeto 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 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 constructores siguientes:

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

Nombre	Description
DeleteCommand	Obtiene o establece una instrucción SQL para eliminar registros del conjunto de datos.
InsertCommand	Obtiene o establece una instrucción SQL que se usa para insertar registros nuevos 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 filtrarse o generar un error. (Heredado de IDataAdapter)
MissingSchemaAction	Indica o especifica si faltan tablas de origen, columnas y sus relaciones se agregan al esquema del conjunto de datos, se omiten o se produce un error. (Heredado de IDataAdapter)
SelectCommand	Obtiene o establece una instrucción SQL que se usa 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 que se usa para actualizar los registros del origen de datos.

Métodos

Nombre	Description
Fill(DataSet)	Agrega o actualiza las filas de DataSet para que coincidan con las del origen de datos con el DataSet nombre y crea un DataTable denominado "Table". (Heredado de IDataAdapter)
FillSchema(DataSet, SchemaType)	Agrega un DataTable denominado "Table" al especificado DataSet y configura el esquema para que coincida con el del origen de datos basado en el especificado SchemaType. (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 correspondientes para cada fila insertada, actualizada o eliminada en el especificado DataSet de un DataTable denominado "Table". (Heredado de IDataAdapter)