DbDataAdapter Clase

Definición

Facilita la implementación de la interfaz IDbDataAdapter. 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.

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

Comentarios

La DbDataAdapter clase hereda de la DataAdapter clase e implementa la IDbDataAdapter interfaz . Ayuda a una clase a implementar un DataAdapter diseñado para su uso con una base de datos relacional.

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

Las clases que heredan DbDataAdapter deben implementar los miembros heredados y normalmente definir miembros adicionales para agregar funcionalidad específica del proveedor. Por ejemplo, la DbDataAdapter clase define la SelectCommand propiedad y la DbDataAdapter clase define ocho sobrecargas del Fill método . A su vez, la OleDbDataAdapter clase hereda el Fill método y también define dos sobrecargas adicionales de que toman un objeto Recordset de Fill ADO como parámetro.

Notas a los implementadores

Cuando hereda de la DbDataAdapter clase , se recomienda implementar los siguientes constructores:

Elemento Descripción
*Prv*DataAdapter() Inicializa una nueva instancia de la clase *Prv*DataAdapter.
*Prv*DataAdapter(*Prv*Command *selectCommand*) Inicializa una nueva instancia de la clase *Prv*DataAdapter con la instrucción SELECT de SQL especificada.
*Prv*DataAdapter(string *selectCommandText*, string *selectConnectionString*) Inicializa una nueva instancia de la clase *Prv*DataAdapter con una instrucción SELECT de SQL y una cadena de conexión.
*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 *Prv*Connection.

Para promover la coherencia entre los proveedores de datos de .NET Framework, debe asignar un nombre a la clase heredada con el formato PrvDataAdapter, 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 espacio de nombres System.Data.SqlClient .

Constructores

DbDataAdapter()

Inicializa una nueva instancia de una clase DataAdapter.

DbDataAdapter(DbDataAdapter)

Inicializa una nueva instancia de la DataAdapter clase a partir de un objeto existente del mismo tipo.

Campos

DefaultSourceTableName

Nombre predeterminado que el objeto DataAdapter utiliza para las asignaciones de tabla.

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.

(Heredado de DataAdapter)
AcceptChangesDuringUpdate

Obtiene o establece si se llama a AcceptChanges() durante una operación Update(DataSet).

(Heredado de DataAdapter)
CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.

(Heredado de Component)
Container

Obtiene la interfaz IContainer que contiene la clase 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.

(Heredado de DataAdapter)
DeleteCommand

Obtiene o establece un comando para eliminar registros del conjunto de datos.

DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.

(Heredado de Component)
Events

Obtiene la lista de controladores de eventos asociados a Component.

(Heredado de Component)
FillCommandBehavior

Obtiene o establece el comportamiento del comando utilizado para rellenar el adaptador de datos.

FillLoadOption

Obtiene o establece el valor de LoadOption que determina cómo rellena el adaptador el objeto DataTable a partir de DbDataReader.

(Heredado de DataAdapter)
InsertCommand

Obtiene o establece un comando que se usa para insertar registros nuevos en el origen de datos.

MissingMappingAction

Determina la acción que hay que llevar a cabo si los datos entrantes no tienen una tabla o una columna coincidente.

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

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

(Heredado de DataAdapter)
SelectCommand

Obtiene o establece un comando que se utiliza para seleccionar registros en el origen de datos.

Site

Obtiene o establece ISite de Component.

(Heredado de Component)
TableMappings

Obtiene una colección que proporciona la asignación principal entre una tabla de origen y .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.

UpdateCommand

Obtiene o establece un comando que se utiliza para actualizar registros en el origen de datos.

Métodos

AddToBatch(IDbCommand)

Agrega una interfaz IDbCommand al lote actual.

ClearBatch()

Quita todos los objetos IDbCommand del lote.

CloneInternals()
Obsoletos.
Obsoletos.
Obsoletos.
Obsoletos.

Crea una copia de esta instancia de 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.

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

Inicializa una nueva instancia de la clase RowUpdatedEventArgs.

CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

Inicializa una nueva instancia de la clase RowUpdatingEventArgs.

CreateTableMappings()

Crea un nuevo DataTableMappingCollection.

(Heredado de DataAdapter)
Dispose()

Libera todos los recursos que usa Component.

(Heredado de Component)
Dispose(Boolean)

Libera los recursos no administrados que usa DbDataAdapter y, de forma opcional, libera los recursos administrados.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
ExecuteBatch()

Ejecuta el lote actual.

Fill(DataSet)

Agrega o actualiza filas en 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.

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.

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.

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.

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 y DataTable.

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

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.

Fill(DataTable, IDataReader)

Agrega filas al objeto DataTable o las actualiza para hacerlas coincidir con las del origen de datos, utilizando el nombre de DataTable y la interfaz IDataReader especificada.

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

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.

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

Fill(Int32, Int32, DataTable[])

Agrega o actualiza filas en uno o varios DataTable objetos para que coincidan con los del origen de datos a partir del registro especificado y recuperando hasta el número máximo de registros especificado.

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.

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

Agrega un elemento DataTable denominado "Table" para el elemento DataSet especificado y configura el esquema para que coincida con el origen de datos basado en el SchemaType.

FillSchema(DataSet, SchemaType, String)

Agrega un elemento DataTable denominado "Table" para el elemento DataSet especificado y configura el esquema para que coincida con el del origen de datos basado en los elementos especificados SchemaType y DataTable.

FillSchema(DataSet, SchemaType, String, IDataReader)

Agrega un objeto DataTable al objeto DataSet especificado.

(Heredado de DataAdapter)
FillSchema(DataTable, SchemaType)

Configura el esquema del elemento DataTable especificado en función del elemento SchemaType especificado.

FillSchema(DataTable, SchemaType, IDataReader)

Agrega un objeto DataTable al objeto DataSet especificado.

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

GetBatchedParameter(Int32, Int32)

Devuelve una interfaz IDataParameter de uno de los comandos del lote actual.

GetBatchedRecordsAffected(Int32, Int32, Exception)

Devuelve información sobre un intento de actualización dentro de una actualización más amplia por lotes.

GetFillParameters()

Obtiene los parámetros establecidos por el usuario al ejecutar una instrucción SELECT de SQL.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetLifetimeService()
Obsoletos.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.

(Heredado de Component)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
HasTableMappings()

Indica si se ha creado una colección DataTableMappingCollection.

(Heredado de DataAdapter)
InitializeBatching()

Inicializa el procesamiento por lotes de DbDataAdapter.

InitializeLifetimeService()
Obsoletos.

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.

(Heredado de MarshalByRefObject)
OnFillError(FillErrorEventArgs)

Genera el evento FillError.

OnFillError(FillErrorEventArgs)

Se invoca cuando se produce un error durante una operación Fill.

(Heredado de DataAdapter)
OnRowUpdated(RowUpdatedEventArgs)

Provoca el evento RowUpdated de un proveedor de datos de .NET.

OnRowUpdating(RowUpdatingEventArgs)

Provoca el evento RowUpdating de un proveedor de datos de .NET.

ResetFillLoadOption()

Restablece FillLoadOption a su estado predeterminado y hace que Fill(DataSet) tenga en cuenta AcceptChangesDuringFill.

(Heredado de DataAdapter)
ShouldSerializeAcceptChangesDuringFill()

Determina si la propiedad AcceptChangesDuringFill debe persistir.

(Heredado de DataAdapter)
ShouldSerializeFillLoadOption()

Determina si la propiedad FillLoadOption debe persistir.

(Heredado de DataAdapter)
ShouldSerializeTableMappings()

Determina si uno o más objetos DataTableMapping existen y si deben almacenarse.

(Heredado de DataAdapter)
TerminateBatching()

Finaliza el procesamiento por lotes para DbDataAdapter.

ToString()

Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar.

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

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 DataRow especificada.

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.

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.

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.

Eventos

Disposed

Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose().

(Heredado de Component)
FillError

Se devuelve cuando se produce un error durante una operación de relleno.

FillError

Se devuelve cuando se produce un error durante una operación de relleno.

(Heredado de DataAdapter)

Implementaciones de interfaz explícitas

ICloneable.Clone()
Obsoletos.

Crea un nuevo objeto copiado de la instancia actual.

IDataAdapter.TableMappings

Obtiene una colección que indica cómo se asigna una tabla de origen a una tabla de conjunto de datos.

(Heredado de DataAdapter)
IDbDataAdapter.DeleteCommand

Obtiene o establece una instrucción SQL para eliminar registros del conjunto de datos.

IDbDataAdapter.InsertCommand

Obtiene o establece una instrucción SQL utilizada para insertar nuevos registros en el origen de datos.

IDbDataAdapter.SelectCommand

Obtiene o establece una instrucción SQL utilizada para seleccionar registros en el origen de datos.

IDbDataAdapter.UpdateCommand

Obtiene o establece una instrucción SQL utilizada para actualizar registros en el origen de datos.

Se aplica a

Consulte también