DbDataAdapter Clase

Definición

Espacio de nombres:

System.Data.Common

Ensamblados:

netstandard.dll, System.Data.Common.dll

Source:

DbDataAdapter.cs

Ayuda a la implementación de la IDbDataAdapter interfaz. Los heredadores de DbDataAdapter implementan un conjunto de funciones para proporcionar escritura segura, pero heredan la mayoría de las funciones necesarias para implementar completamente un 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 IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapter

Herencia

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

Derivado

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Implementaciones

IDataAdapter IDbDataAdapter ICloneable

Comentarios

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

Una aplicación no crea una instancia de la DbDataAdapter clase directamente, pero 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

Al heredar de la DbDataAdapter clase , se recomienda implementar los constructores siguientes:

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 en el formulario 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

Nombre	Description
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

Nombre	Description
DefaultSourceTableName	Nombre predeterminado usado por el DataAdapter objeto para las asignaciones de tablas.

Propiedades

Nombre	Description
AcceptChangesDuringFill	Obtiene o establece un valor que indica si AcceptChanges() se llama a en una DataRow después de agregarlo a DataTable durante cualquiera de las operaciones Fill . (Heredado de DataAdapter)
AcceptChangesDuringUpdate	Obtiene o establece si AcceptChanges() se llama a durante un Update(DataSet)objeto . (Heredado de DataAdapter)
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
Container	Obtiene el IContainer objeto que contiene el Componentobjeto . (Heredado de Component)
ContinueUpdateOnError	Obtiene o establece un valor que especifica si se va a generar 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 el objeto está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos que están asociados a este Componentobjeto . (Heredado de Component)
FillCommandBehavior	Obtiene o establece el comportamiento del comando usado para rellenar el adaptador de datos.
FillLoadOption	Obtiene o establece el LoadOption objeto que determina cómo el adaptador rellena desde DataTable .DbDataReader (Heredado de DataAdapter)
InsertCommand	Obtiene o establece un comando usado para insertar registros nuevos en el origen de datos.
MissingMappingAction	Determina la acción que se debe realizar cuando los datos entrantes no tienen una tabla o columna coincidente. (Heredado de DataAdapter)
MissingSchemaAction	Determina la acción que se debe realizar cuando el esquema existente DataSet no coincide con los datos entrantes. (Heredado de DataAdapter)
ReturnProviderSpecificTypes	Obtiene o establece si el Fill método debe devolver valores específicos del proveedor o valores comunes compatibles con CLS. (Heredado de DataAdapter)
SelectCommand	Obtiene o establece un comando que se usa para seleccionar registros en el origen de datos.
Site	Obtiene o establece el ISite objeto 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 usado para actualizar registros en el origen de datos.

Métodos

Nombre	Description
AddToBatch(IDbCommand)	Agrega un IDbCommand objeto al lote actual.
ClearBatch()	Quita todos los IDbCommand objetos del lote.
CloneInternals()	Obsoletos. Crea una copia de esta instancia de DataAdapter. (Heredado de DataAdapter)
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 DataTableMappingCollectionobjeto . (Heredado de DataAdapter)
Dispose()	Libera todos los recursos usados por .Component (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados utilizados por DbDataAdapter y, opcionalmente, libera los recursos administrados.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
ExecuteBatch()	Ejecuta el lote actual.
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Agrega o actualiza las filas de un intervalo especificado en DataSet para que coincidan con las del origen de datos mediante los nombres de tabla de origen y , la cadena de comandos y el DataSet comportamiento del comando.
Fill(DataSet, Int32, Int32, String)	Agrega o actualiza las filas de un intervalo especificado en DataSet para que coincidan con las del origen de datos mediante los DataSet nombres y DataTable .
Fill(DataSet, String, IDataReader, Int32, Int32)	Agrega o actualiza las filas de un intervalo especificado en DataSet para que coincidan con las del origen de datos mediante los DataSet nombres y DataTable . (Heredado de DataAdapter)
Fill(DataSet, String)	Agrega o actualiza las filas de DataSet para que coincidan con las del origen de datos mediante los DataSet nombres y DataTable .
Fill(DataSet)	Agrega o actualiza filas en .DataSet
Fill(DataTable, IDataReader)	Agrega o actualiza las filas de DataTable para que coincidan con las del origen de datos mediante el DataTable nombre y el especificado IDataReader. (Heredado de DataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Agrega o actualiza las filas de para DataTable que coincidan con las del origen de datos mediante el especificado IDbCommandDataTabley CommandBehavior.
Fill(DataTable)	Agrega o actualiza las filas de un intervalo especificado en DataSet para que coincidan con las del origen de datos con el DataTable nombre .
Fill(DataTable[], IDataReader, Int32, Int32)	Agrega o actualiza las filas de un intervalo especificado en la colección de objetos para que coincidan con las del origen de DataTable datos. (Heredado de DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	Agrega o actualiza las filas de un intervalo especificado en DataSet para que coincidan con las del origen de datos mediante los DataSet nombres 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, IDbCommand, String, CommandBehavior)	Agrega un DataTable objeto al especificado DataSet y configura el esquema para que coincida con el del origen de datos basado en el especificado SchemaType.
FillSchema(DataSet, SchemaType, String, IDataReader)	Agrega un DataTable objeto al objeto especificado DataSet. (Heredado de DataAdapter)
FillSchema(DataSet, SchemaType, String)	Agrega un DataTable objeto al especificado DataSet y configura el esquema para que coincida con el del origen de datos en función del especificado SchemaType y DataTable.
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.
FillSchema(DataTable, SchemaType, IDataReader)	Agrega un DataTable objeto al objeto especificado DataSet. (Heredado de DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Configura el esquema del especificado DataTable en función de la cadena de comandos y CommandBehavior los valores especificadosSchemaType.
FillSchema(DataTable, SchemaType)	Configura el esquema del especificado DataTable en función del especificado SchemaType.
GetBatchedParameter(Int32, Int32)	Devuelve un objeto IDataParameter de uno de los comandos del lote actual.
GetBatchedRecordsAffected(Int32, Int32, Exception)	Devuelve información sobre un intento de actualización individual dentro de una actualización por lotes mayor.
GetFillParameters()	Obtiene los parámetros establecidos por el usuario al ejecutar una instrucción SELECT de SQL.
GetHashCode()	Actúa como 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 un servicio proporcionado por Component o por su Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
HasTableMappings()	Indica si se ha creado un DataTableMappingCollection objeto . (Heredado de DataAdapter)
InitializeBatching()	Inicializa el procesamiento por lotes para .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 Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto actual MarshalByRefObject . (Heredado de MarshalByRefObject)
OnFillError(FillErrorEventArgs)	Se invoca cuando se produce un error durante un Fill. (Heredado de DataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	Genera el RowUpdated evento de un proveedor de datos de .NET.
OnRowUpdating(RowUpdatingEventArgs)	Genera el RowUpdating evento de un proveedor de datos de .NET.
ResetFillLoadOption()	FillLoadOption Restablece su estado predeterminado y hace que Fill(DataSet) se respete AcceptChangesDuringFill. (Heredado de DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Determina si la AcceptChangesDuringFill propiedad debe conservarse. (Heredado de DataAdapter)
ShouldSerializeFillLoadOption()	Determina si la FillLoadOption propiedad debe conservarse. (Heredado de DataAdapter)
ShouldSerializeTableMappings()	Determina si existen uno o varios DataTableMapping objetos y se deben conservar. (Heredado de DataAdapter)
TerminateBatching()	Finaliza el procesamiento por lotes para .DbDataAdapter
ToString()	Devuelve un String objeto que contiene el nombre de Component, si existe. Este método no se debe invalidar. (Heredado de Component)
Update(DataRow[], DataTableMapping)	Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE correspondientes para cada fila insertada, actualizada o eliminada en la matriz de DataRow objetos especificada.
Update(DataRow[])	Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE correspondientes para cada fila insertada, actualizada o eliminada de la matriz especificada en DataSet.
Update(DataSet, String)	Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en con DataSet el nombre especificado DataTable .
Update(DataSet)	Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE correspondientes para cada fila insertada, actualizada o eliminada en el especificado DataSet.
Update(DataTable)	Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE correspondientes para cada fila insertada, actualizada o eliminada en el especificado DataTable.

Eventos

Nombre	Description
Disposed	Se produce cuando el componente se elimina mediante una llamada al Dispose() método . (Heredado de Component)
FillError	Se devuelve cuando se produce un error durante una operación de relleno. (Heredado de DataAdapter)

Implementaciones de interfaz explícitas

Nombre	Description
ICloneable.Clone()	Crea un nuevo objeto que es una copia 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 que se usa para insertar registros nuevos en el origen de datos.
IDbDataAdapter.SelectCommand	Obtiene o establece una instrucción SQL que se usa para seleccionar registros en el origen de datos.
IDbDataAdapter.UpdateCommand	Obtiene o establece una instrucción SQL que se usa para actualizar los registros del origen de datos.

Consulte también

• DbProviderFactories (ADO.NET)
• Información general de ADO.NET