DataAdapter Clase

Definición

Representa un conjunto de comandos SQL y una conexión de base de datos que se utilizan para rellenar el objeto DataSet y actualizar el origen de datos.Represents a set of SQL commands and a database connection that are used to fill the DataSet and update the data source.

public ref class DataAdapter : System::ComponentModel::Component, System::Data::IDataAdapter
public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter
type DataAdapter = class
    inherit Component
    interface IDataAdapter
Public Class DataAdapter
Inherits Component
Implements IDataAdapter
Herencia
Derivado
Implementaciones

Comentarios

El DataAdapter actúa como un puente entre un DataSet y un origen de datos para recuperar y guardar datos.The DataAdapter serves as a bridge between a DataSet and a data source for retrieving and saving data. El DataAdapter proporciona este puente asignando Fill, que cambia los datos de la DataSet para que coincidan con los datos del origen de datos y Update, que cambia los datos en el origen de datos para que coincidan con los datos de la DataSet.The DataAdapter provides this bridge by mapping Fill, which changes the data in the DataSet to match the data in the data source, and Update, which changes the data in the data source to match the data in the DataSet.

Si se está conectando a una base de datos de SQL Server, puede aumentar el rendimiento general mediante el SqlDataAdapter junto con sus objetos SqlCommand y SqlConnection asociados.If you are connecting to a SQL Server database, you can increase overall performance by using the SqlDataAdapter along with its associated SqlCommand and SqlConnection objects. En el caso de los orígenes de datos compatibles con OLE DB, utilice el DataAdapter con sus objetos OleDbCommand y OleDbConnection asociados.For OLE DB-supported data sources, use the DataAdapter with its associated OleDbCommand and OleDbConnection objects. En el caso de orígenes de datos compatibles con ODBC, utilice el DataAdapter con sus objetos OdbcCommand y OdbcConnection asociados.For ODBC-supported data sources, use the DataAdapter with its associated OdbcCommand and OdbcConnection objects. En el caso de las bases de datos de Oracle, utilice el DataAdapter con sus objetos OracleCommand y OracleConnection asociados.For Oracle databases, use the DataAdapter with its associated OracleCommand and OracleConnection objects.

Cuando se crea una instancia de DataAdapter, las propiedades de lectura y escritura se establecen en valores iniciales.When an instance of DataAdapter is created, the read/write properties are set to initial values. Para obtener una lista de estos valores, vea el constructor DataAdapter.For a list of these values, see the DataAdapter constructor.

Constructores

DataAdapter()

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

DataAdapter(DataAdapter)

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.

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.

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

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.

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

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.

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.

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.

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.

Métodos

CloneInternals()

Crea una copia de esta instancia de DataAdapter.Creates a copy of this instance of 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)
CreateTableMappings()

Crea un nuevo DataTableMappingCollection.Creates a new DataTableMappingCollection.

Dispose()

Libera todos los recursos que ha usado el objeto Component.Releases all resources used by the Component.

(Heredado de Component)
Dispose(Boolean)

Libera los recursos no administrados que usa el objeto DataAdapter y, opcionalmente, libera los recursos administrados.Releases the unmanaged resources used by the DataAdapter 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)
Fill(DataSet)

Agrega o actualiza las filas del objeto DataSet para que se correspondan con las del origen de datos.Adds or refreshes rows in the DataSet to match those in the data source.

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.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(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.Adds or refreshes rows in the DataTable to match those in the data source using the DataTable name and the specified IDataReader.

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.

FillSchema(DataSet, SchemaType)

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, IDataReader)

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

FillSchema(DataTable, SchemaType, IDataReader)

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

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.

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)

Se invoca cuando se produce un error durante una operación Fill.Invoked when an error occurs during a Fill.

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.

ShouldSerializeAcceptChangesDuringFill()

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

ShouldSerializeFillLoadOption()

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

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.

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(DataSet)

Llama a las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en el objeto DataSet especificado 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."

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

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.

Se aplica a

Consulte también: