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 Framework que tienen acceso a bases de datos relacionales.Represents a set of command-related properties that are used to fill the DataSet and update a data source, and is implemented by .NET Framework data providers that access relational databases.

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 SqlCommandderivadas SqlConnection, SqlDataAdapter y, para seleccionar registros de un origen de datos.The following example uses the derived classes, SqlCommand, SqlDataAdapter and SqlConnection, to select records from a data source. A continuación DataSet , se devuelve el rellenado.The filled DataSet is then returned. Para ello, se pasa al método un inicializado DataSet, una cadena de conexión y una cadena de consulta que es una instrucción SELECT de Transact-SQL.To accomplish 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 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.The IDbDataAdapter interface inherits from the IDataAdapter interface and allows an object to create a DataAdapter designed for use with a relational database. La IDbDataAdapter interfaz y, opcionalmente, la clase de utilidad DbDataAdapter,, permiten que una clase heredada implemente una clase DataAdapter, que representa el puente entre un origen de DataSetdatos y un.The IDbDataAdapter interface and, optionally, the utility class, DbDataAdapter, allow 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. Para obtener más información sobre cómo implementar .NET Framework proveedores de datos, vea implementar un proveedor de datos de .NET Framework.For more information about implementing .NET Framework data providers, see Implementing a .NET Framework Data Provider.

Una aplicación no crea una instancia de la IDbDataAdapter interfaz directamente, sino que crea una instancia de una clase que IDbDataAdapter hereda y DbDataAdapter.An application does not create an instance of the IDbDataAdapter interface directly, but creates an instance of a class that inherits IDbDataAdapter and DbDataAdapter.

Las clases que IDbDataAdapter heredan deben implementar los miembros heredados y, normalmente, definir miembros adicionales para agregar funcionalidad específica del proveedor.Classes that inherit IDbDataAdapter must implement the inherited members, and typically define additional members to add provider-specific functionality. Por ejemplo, la IDbDataAdapter interfaz define la SelectCommand propiedad y la DbDataAdapter interfaz define un Fill método que toma DataTable como parámetro.For example, the IDbDataAdapter interface defines the SelectCommand property, and the DbDataAdapter interface defines a Fill method that takes a DataTable as a parameter. A su vez, OleDbDataAdapter la clase hereda la SelectCommand propiedad y el Fill método, y también Fill define dos sobrecargas adicionales del método que toman un objeto de conjunto de registros ADO como parámetro.In turn, the OleDbDataAdapter class inherits the SelectCommand property and 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 un nombre a la clase Prv heredada Prv con el formato DataAdapter, donde es el prefijo uniforme dado a todas las clases de un espacio de nombres de proveedor de datos .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 SqlDataAdapter la clase en System.Data.SqlClient el espacio de nombres.For example, Sql is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

Al heredar de la IDbDataAdapter interfaz, debe implementar los siguientes constructores:When you inherit from the IDbDataAdapter 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 with 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 with 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 with an SQL SELECT statement and a PrvConnection object.

Propiedades

DeleteCommand

Obtiene o establece una instrucción SQL para eliminar registros del conjunto de datos.Gets or sets an SQL statement for deleting records from the data set.

InsertCommand

Obtiene o establece una instrucción SQL utilizada para insertar nuevos registros en el origen de datos.Gets or sets an SQL statement used to insert new records into the data source.

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.

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

(Heredado de IDataAdapter)
SelectCommand

Obtiene o establece una instrucción SQL utilizada para seleccionar registros en el origen de datos.Gets or sets an SQL statement used to select records in the data source.

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.

(Heredado de IDataAdapter)
UpdateCommand

Obtiene o establece una instrucción SQL utilizada para actualizar registros en el origen de datos.Gets or sets an SQL statement used to update records in the data source.

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

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

(Heredado de IDataAdapter)
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.

(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".Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet from a DataTable named "Table".

(Heredado de IDataAdapter)

Se aplica a