DbDataAdapter Clase

Definición

Sirve de ayuda para implementar la interfaz IDbDataAdapter.Aids implementation of the IDbDataAdapter interface. Los herederos de DbDataAdapter implementan un conjunto de funciones para proporcionar un tipado fuerte, pero heredan la mayoría de las funciones necesarias para implementar completamente un elemento DataAdapter.Inheritors of DbDataAdapter implement a set of functions to provide strong typing, but inherit most of the functionality needed to fully implement a DataAdapter.

public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable, System::Data::IDbDataAdapter
public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapter
type DbDataAdapter = class
    inherit DataAdapter
    interface IDbDataAdapter
    interface ICloneable
    interface IDataAdapter
Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapter
Herencia
Derivado
Implementaciones

Comentarios

La DbDataAdapter clase hereda de la DataAdapter clase e implementa la IDbDataAdapter interfaz.The DbDataAdapter class inherits from the DataAdapter class and implements the IDbDataAdapter interface. Ayuda a una clase a implementar un DataAdapter diseñado para su uso con una base de datos relacional.It helps a class implement a DataAdapter designed for use with a relational database.

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

Las clases que DbDataAdapter heredan deben implementar los miembros heredados y, normalmente, definir miembros adicionales para agregar funcionalidad específica del proveedor.Classes that inherit DbDataAdapter must implement the inherited members, and typically define additional members to add provider-specific functionality. Por ejemplo, la DbDataAdapter clase define la SelectCommand propiedad y la DbDataAdapter Fill clase define ocho sobrecargas del método.For example, the DbDataAdapter class defines the SelectCommand property, and the DbDataAdapter class defines eight overloads of the Fill method. A su vez, OleDbDataAdapter la clase hereda el Fill método y también define dos sobrecargas adicionales de Fill que toman un objeto de conjunto de registros ADO como parámetro.In turn, the OleDbDataAdapter class inherits the Fill method, and also defines two additional overloads of Fill that take an ADO Recordset object as a parameter.

Notas a los implementadores

Cuando se hereda de la DbDataAdapter clase, se recomienda implementar los siguientes constructores:When you inherit from the DbDataAdapter class, we recommend that you implement the following constructors:

ElementoItem DescripciónDescription
*Prv*DataAdapter()*Prv*DataAdapter() Inicializa una nueva instancia de la clase *PRV*DataAdapter.Initializes a new instance of the *Prv*DataAdapter class.
*PRV* DataAdapter (\*\* comando PRV *SelectCommand*)*Prv*DataAdapter(*Prv*Command *selectCommand*) Inicializa una nueva instancia de la clase *PRV*DataAdapter con la instrucción SQL SELECT especificada.Initializes a new instance of the *Prv*DataAdapter class with the specified SQL SELECT statement.
*PRV* DataAdapter (String *selectCommandText*, String *selectConnectionString*)*Prv*DataAdapter(string *selectCommandText*, string *selectConnectionString*) Inicializa una nueva instancia de la clase *PRV*DataAdapter con una instrucción SQL SELECT y una cadena de conexión.Initializes a new instance of the *Prv*DataAdapter class with an SQL SELECT statement and a connection string.
*PRV* DataAdapter (String *selectCommandText*, *PRV*Connection *selectConnection*)*Prv*DataAdapter(string *selectCommandText*, *Prv*Connection *selectConnection*) Inicializa una nueva instancia de la clase *PRV*DataAdapter con una instrucción SELECT de SQL y un objeto de conexión *PRV*.Initializes a new instance of the *Prv*DataAdapter class with an SQL SELECT statement and a *Prv*Connection object.

Para promover la coherencia entre .NET Framework proveedores de datos, debe asignar el nombre de la clase heredada con el formato PRVDataAdapter, donde PRV es el prefijo uniforme que se asigna a todas las clases de un espacio de nombres del proveedor de datos .NET Framework específico.To promote consistency among .NET Framework data providers, you should name the inheriting class in the form PrvDataAdapter, 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 el espacio de nombres System. Data. SqlClient .For example, "Sql" is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

Constructores

DbDataAdapter()

Inicializa una nueva instancia de una clase DataAdapter.Initializes a new instance of a DataAdapter class.

DbDataAdapter(DbDataAdapter)

Inicializa una nueva instancia de la clase DataAdapter a partir de un objeto existente del mismo tipo.Initializes a new instance of a DataAdapter class from an existing object of the same type.

Campos

DefaultSourceTableName

Nombre predeterminado que el objeto DataAdapter utiliza para las asignaciones de tabla.The default name used by the DataAdapter object for table mappings.

Propiedades

AcceptChangesDuringFill

Obtiene o establece un valor que indica si se llama a AcceptChanges() en un elemento DataRow después de agregarlo a DataTable durante cualquiera de las operaciones Fill.Gets or sets a value indicating whether AcceptChanges() is called on a DataRow after it is added to the DataTable during any of the Fill operations.

(Heredado de DataAdapter)
AcceptChangesDuringUpdate

Obtiene o establece si se llama a AcceptChanges() durante una operación Update(DataSet).Gets or sets whether AcceptChanges() is called during a Update(DataSet).

(Heredado de DataAdapter)
CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(Heredado de Component)
Container

Obtiene IContainer que contiene Component.Gets the IContainer that contains the Component.

(Heredado de Component)
ContinueUpdateOnError

Obtiene o establece un valor que especifica si debe generarse una excepción cuando se produce un error durante una actualización de fila.Gets or sets a value that specifies whether to generate an exception when an error is encountered during a row update.

(Heredado de DataAdapter)
DeleteCommand

Obtiene o establece un comando para eliminar registros del conjunto de datos.Gets or sets a command for deleting records from the data set.

DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.Gets a value that indicates whether the Component is currently in design mode.

(Heredado de Component)
Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this Component.

(Heredado de Component)
FillCommandBehavior

Obtiene o establece el comportamiento del comando utilizado para rellenar el adaptador de datos.Gets or sets the behavior of the command used to fill the data adapter.

FillLoadOption

Obtiene o establece el valor de LoadOption que determina cómo rellena el adaptador el objeto DataTable a partir de DbDataReader.Gets or sets the LoadOption that determines how the adapter fills the DataTable from the DbDataReader.

(Heredado de DataAdapter)
InsertCommand

Obtiene o establece un comando que se utiliza para insertar nuevos registros en el origen de datos.Gets or sets a command used to insert new records into the data source.

MissingMappingAction

Determina la acción que hay que llevar a cabo si los datos entrantes no tienen una tabla o una columna coincidente.Determines the action to take when incoming data does not have a matching table or column.

(Heredado de DataAdapter)
MissingSchemaAction

Determina la acción que hay que llevar a cabo cuando el esquema DataSet existente no coincide con los datos entrantes.Determines the action to take when existing DataSet schema does not match incoming data.

(Heredado de DataAdapter)
ReturnProviderSpecificTypes

Obtiene o establece un valor que indica si el método Fill debe devolver valores específicos del proveedor o valores comunes conforme a CLS.Gets or sets whether the Fill method should return provider-specific values or common CLS-compliant values.

(Heredado de DataAdapter)
SelectCommand

Obtiene o establece un comando que se utiliza para seleccionar registros en el origen de datos.Gets or sets a command used to select records in the data source.

Site

Obtiene o establece el ISite de Component.Gets or sets the ISite of the Component.

(Heredado de Component)
TableMappings

Obtiene una colección que proporciona la asignación principal entre una tabla de origen y DataTable.Gets a collection that provides the master mapping between a source table and a DataTable.

(Heredado de DataAdapter)
UpdateBatchSize

Obtiene o establece un valor que habilita o deshabilita la compatibilidad con el procesamiento por lotes, y especifica el número de comandos que se pueden ejecutar en un lote.Gets or sets a value that enables or disables batch processing support, and specifies the number of commands that can be executed in a batch.

UpdateCommand

Obtiene o establece un comando que se utiliza para actualizar registros en el origen de datos.Gets or sets a command used to update records in the data source.

Métodos

AddToBatch(IDbCommand)

Agrega una interfaz IDbCommand al lote actual.Adds a IDbCommand to the current batch.

ClearBatch()

Quita todos los objetos IDbCommand del lote.Removes all IDbCommand objects from the batch.

CloneInternals()

Crea una copia de esta instancia de DataAdapter.Creates a copy of this instance of DataAdapter.

(Heredado de DataAdapter)
CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

Inicializa una nueva instancia de la clase RowUpdatedEventArgs.Initializes a new instance of the RowUpdatedEventArgs class.

CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

Inicializa una nueva instancia de la clase RowUpdatingEventArgs.Initializes a new instance of the RowUpdatingEventArgs class.

CreateTableMappings()

Crea un nuevo DataTableMappingCollection.Creates a new DataTableMappingCollection.

(Heredado de DataAdapter)
Dispose()

Libera todos los recursos que usa Component.Releases all resources used by the Component.

(Heredado de Component)
Dispose(Boolean)

Libera los recursos no administrados que usa DbDataAdapter y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the DbDataAdapter and optionally releases the managed resources.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
ExecuteBatch()

Ejecuta el lote actual.Executes the current batch.

Fill(DataSet)

Agrega o actualiza filas en DataSet.Adds or refreshes rows in the DataSet.

Fill(DataSet, Int32, Int32, String)

Agrega filas en un intervalo especificado de DataSet o las actualiza para hacerlas coincidir con las filas del origen de datos utilizando los nombres de DataSet y DataTable.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)

Agrega filas en un intervalo especificado de DataSet o las actualiza para hacerlas coincidir con las filas del origen de datos utilizando los nombres de DataSet y los nombres de tabla de origen, la cadena de comando y el comportamiento de comando.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and source table names, command string, and command behavior.

Fill(DataSet, String)

Agrega filas a DataSet o las actualiza para hacerlas coincidir con las filas del origen de datos utilizando los nombres de DataSet y DataTable.Adds or refreshes rows in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(DataSet, String, IDataReader, Int32, Int32)

Agrega filas en un intervalo especificado de DataSet o las actualiza para hacerlas coincidir con las filas del origen de datos utilizando los nombres de DataSet, DataTable y IDataReader.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet, DataTable, and IDataReader names.

Fill(DataTable)

Agrega filas en un intervalo especificado de DataSet o las actualiza para hacerlas coincidir con las filas del origen de datos utilizando el nombre de DataTable.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataTable name.

Fill(DataTable, IDataReader)

Agrega filas a un objeto DataTable o las actualiza para hacerlas coincidir con las del origen de datos, utilizando los nombres de DataTable y IDataReader especificados.Adds or refreshes rows in a DataTable to match those in the data source using the specified DataTable and IDataReader names.

Fill(DataTable, IDbCommand, CommandBehavior)

Agrega filas a un objeto DataTable o las actualiza para hacerlas coincidir con las del origen de datos, utilizando los objetos DataTable, IDbCommand y CommandBehavior especificados.Adds or refreshes rows in a DataTable to match those in the data source using the specified DataTable, IDbCommand and CommandBehavior.

Fill(DataTable[], IDataReader, Int32, Int32)

Agrega filas en un intervalo especificado de la colección de objetos DataTable o las actualiza para hacerlas coincidir con las filas del origen de datos.Adds or refreshes rows in a specified range in the collection of DataTable objects to match those in the data source.

(Heredado de DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)

Agrega filas en un intervalo especificado de DataSet o las actualiza para hacerlas coincidir con las filas del origen de datos utilizando los nombres de DataSet y DataTable.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(Int32, Int32, DataTable[])

Agrega filas a DataTable o las actualiza para hacerlas coincidir con las del origen de datos, empezando en el registro especificado y recuperando hasta el número máximo de registros especificado.Adds or refreshes rows in a DataTable to match those in the data source starting at the specified record and retrieving up to the specified maximum number of records.

FillSchema(DataSet, SchemaType)

Agrega un objeto DataTable denominado "Table" a la interfaz DataSet que se ha especificado y configura el esquema para que coincida con el del origen de datos en función de la SchemaType especificada.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.

FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)

Agrega DataTable al DataSet especificado y configura el esquema para hacerlo coincidir con el del origen de datos en función del tipo SchemaType especificado.Adds a DataTable to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

FillSchema(DataSet, SchemaType, String)

Agrega DataTable al DataSet especificado y configura el esquema para hacerlo coincidir con el del origen de datos en función del tipo SchemaType y la tabla DataTable especificados.Adds a DataTable to the specified DataSet and configures the schema to match that in the data source based upon the specified SchemaType and DataTable.

FillSchema(DataSet, SchemaType, String, IDataReader)

Agrega un objeto DataTable al objeto DataSet especificado.Adds a DataTable to the specified DataSet.

(Heredado de DataAdapter)
FillSchema(DataTable, SchemaType)

Configura el esquema de la tabla DataTable especificada en función del tipo SchemaType especificado.Configures the schema of the specified DataTable based on the specified SchemaType.

FillSchema(DataTable, SchemaType, IDataReader)

Agrega un objeto DataTable al objeto DataSet especificado.Adds a DataTable to the specified DataSet.

(Heredado de DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)

Configura el esquema de la tabla DataTable especificada en función del SchemaType, la cadena de comando y los valores de CommandBehavior especificados.Configures the schema of the specified DataTable based on the specified SchemaType, command string, and CommandBehavior values.

GetBatchedParameter(Int32, Int32)

Devuelve una interfaz IDataParameter de uno de los comandos del lote actual.Returns a IDataParameter from one of the commands in the current batch.

GetBatchedRecordsAffected(Int32, Int32, Exception)

Devuelve información sobre un intento de actualización dentro de una actualización más amplia por lotes.Returns information about an individual update attempt within a larger batched update.

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.

GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.Returns an object that represents a service provided by the Component or by its Container.

(Heredado de Component)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
HasTableMappings()

Indica si se ha creado una colección DataTableMappingCollection.Indicates whether a DataTableMappingCollection has been created.

(Heredado de DataAdapter)
InitializeBatching()

Inicializa el procesamiento por lotes de DbDataAdapter.Initializes batching for the DbDataAdapter.

InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
OnFillError(FillErrorEventArgs)

Genera el evento FillError.Raises the FillError event.

OnRowUpdated(RowUpdatedEventArgs)

Provoca el evento RowUpdated de un proveedor de datos de .NET Framework.Raises the RowUpdated event of a .NET Framework data provider.

OnRowUpdating(RowUpdatingEventArgs)

Provoca el evento RowUpdating de un proveedor de datos de .NET Framework.Raises the RowUpdating event of a .NET Framework data provider.

ResetFillLoadOption()

Restablece FillLoadOption a su estado predeterminado y hace que Fill(DataSet) tenga en cuenta AcceptChangesDuringFill.Resets FillLoadOption to its default state and causes Fill(DataSet) to honor AcceptChangesDuringFill.

(Heredado de DataAdapter)
ShouldSerializeAcceptChangesDuringFill()

Determina si la propiedad AcceptChangesDuringFill debe persistir.Determines whether the AcceptChangesDuringFill property should be persisted.

(Heredado de DataAdapter)
ShouldSerializeFillLoadOption()

Determina si la propiedad FillLoadOption debe persistir.Determines whether the FillLoadOption property should be persisted.

(Heredado de DataAdapter)
ShouldSerializeTableMappings()

Determina si uno o más objetos DataTableMapping existen y si deben almacenarse.Determines whether one or more DataTableMapping objects exist and they should be persisted.

(Heredado de DataAdapter)
TerminateBatching()

Finaliza el procesamiento por lotes para DbDataAdapter.Ends batching for the DbDataAdapter.

ToString()

Devuelve una String que contiene el nombre del Component, si existe.Returns a String containing the name of the Component, if any. Este método no se debe invalidar.This method should not be overridden.

(Heredado de Component)
Update(DataRow[])

Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en la matriz especificada en DataSet.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified array in the DataSet.

Update(DataRow[], DataTableMapping)

Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en la matriz de objetos DataSet especificada.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified array of DataSet objects.

Update(DataSet)

Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en los objetos DataSet especificados.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet.

Update(DataSet, String)

Actualiza los valores de la base de datos al ejecutar las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en los objetos DataSet con el nombre de DataTable especificado.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the DataSet with the specified DataTable name.

Update(DataTable)

Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en los objetos DataTable especificados.Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataTable.

Eventos

Disposed

Se produce cuando el componente se elimina mediante una llamada al método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Heredado de Component)
FillError

Se devuelve cuando se produce un error durante una operación de relleno.Returned when an error occurs during a fill operation.

Implementaciones de interfaz explícitas

ICloneable.Clone()

Crea un nuevo objeto copiado de la instancia actual.Creates a new object that is a copy of the current instance.

IDataAdapter.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 DataAdapter)
IDbDataAdapter.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.

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

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

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

Se aplica a

Consulte también: