OleDbDataAdapter Clase

Definición

Espacio de nombres:: System.Data.OleDb

Ensamblado:: System.Data.OleDb.dll

Ensamblado:: System.Data.dll

Paquete:: System.Data.OleDb v11.0.0-preview.2.26159.112

Source:: OleDbDataAdapter.cs

Source:: OleDbDataAdapter.cs

Source:: OleDbDataAdapter.cs

Source:: OleDbDataAdapter.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa un conjunto de comandos de datos y una conexión de base de datos que se usan para rellenar y DataSet actualizar el origen de datos.

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter

public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable

type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter

Herencia: Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter
OleDbDataAdapter

Atributos: RequiresDynamicCodeAttribute

Implementaciones: IDataAdapter IDbDataAdapter ICloneable

Ejemplos

En el OleDbCommandejemplo siguiente se usa , OleDbDataAdapter y OleDbConnection, para seleccionar registros de un origen de datos de Access y rellenar un DataSet elemento con las filas seleccionadas. A continuación, se devuelve el relleno DataSet . Para ello, el método se pasa un inicializado DataSet, una cadena de conexión y una cadena de consulta que es una instrucción SELECT de SQL.

public static OleDbDataAdapter CreateDataAdapter(string selectCommand,
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter(selectCommand, connection);

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the Insert, Update and Delete commands.
    adapter.InsertCommand = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)");

    adapter.UpdateCommand = new OleDbCommand(
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?");

    adapter.DeleteCommand = new OleDbCommand(
        "DELETE FROM Customers WHERE CustomerID = ?");

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}

Public Function CreateDataAdapter(ByVal selectCommand As String, _
    ByVal connection As OleDbConnection) As OleDbDataAdapter

    Dim adapter As OleDbDataAdapter = _
        New OleDbDataAdapter(selectCommand, connection)

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey

    ' Create the commands.
    adapter.InsertCommand = New OleDbCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
         "VALUES (?, ?)")

    adapter.UpdateCommand = New OleDbCommand( _
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?")

    adapter.DeleteCommand = New OleDbCommand( _
        "DELETE FROM Customers WHERE CustomerID = ?")

    ' Create the parameters.
    adapter.InsertCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.InsertCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.UpdateCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.UpdateCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")
    adapter.UpdateCommand.Parameters.Add( _
        "@oldCustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    adapter.DeleteCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    Return adapter
End Function

Comentarios

OleDbDataAdapter sirve como puente entre un DataSet origen de datos y para recuperar y guardar datos. OleDbDataAdapter proporciona este puente mediante Fill para cargar datos del origen de datos en DataSety usar Update para enviar los cambios realizados en el DataSet origen de datos de vuelta al origen de datos.

OleDbDataAdapter Cuando rellena un DataSet, creará las tablas y columnas adecuadas para los datos devueltos si aún no existen. Sin embargo, la información de clave principal no se incluye en el esquema creado implícitamente a menos que la MissingSchemaAction propiedad esté establecida AddWithKeyen . También puede tener el OleDbDataAdapter esquema de creación de , incluida la información de DataSetclave principal, antes de rellenarlo con datos mediante FillSchema. Para obtener más información, vea Agregar restricciones existentes a un conjunto de datos.

Tenga en cuenta que algunos proveedores OLE DB, incluido el proveedor MSDataShape, no devuelven información de la tabla base ni de la clave principal. Por lo tanto, no OleDbDataAdapter se puede establecer correctamente la PrimaryKey propiedad en ningún objeto creado DataTable. En estos casos, debe especificar explícitamente las claves principales para las tablas de DataSet.

OleDbDataAdapter también incluye las SelectCommandpropiedades , InsertCommand, DeleteCommand, UpdateCommandy TableMappings para facilitar la carga y actualización de datos.

Al crear una instancia de OleDbDataAdapter, las propiedades se establecen en sus valores iniciales. Para obtener una lista de estos valores, consulte el OleDbDataAdapter constructor .

Constructores

Nombre	Description
OleDbDataAdapter()	Inicializa una nueva instancia de la clase OleDbDataAdapter.
OleDbDataAdapter(OleDbCommand)	Inicializa una nueva instancia de la OleDbDataAdapter clase con el especificado OleDbCommand como la SelectCommand propiedad .
OleDbDataAdapter(String, OleDbConnection)	Inicializa una nueva instancia de la OleDbDataAdapter clase con .SelectCommand
OleDbDataAdapter(String, String)	Inicializa una nueva instancia de la OleDbDataAdapter clase con .SelectCommand

Campos

Nombre	Description
DefaultSourceTableName	Nombre predeterminado usado por el DataAdapter objeto para las asignaciones de tablas. (Heredado de DbDataAdapter)

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 una instrucción SQL o un procedimiento almacenado 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. (Heredado de DbDataAdapter)
FillLoadOption	Obtiene o establece el LoadOption objeto que determina cómo el adaptador rellena desde DataTable .DbDataReader (Heredado de DataAdapter)
InsertCommand	Obtiene o establece una instrucción SQL o un procedimiento almacenado que se usa 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 una instrucción SQL o un procedimiento almacenado 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. (Heredado de DbDataAdapter)
UpdateCommand	Obtiene o establece una instrucción SQL o un procedimiento almacenado que se usa para actualizar los registros del origen de datos.

Métodos

Nombre	Description
AddToBatch(IDbCommand)	Agrega un IDbCommand objeto al lote actual. (Heredado de DbDataAdapter)
ClearBatch()	Quita todos los IDbCommand objetos del lote. (Heredado de DbDataAdapter)
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 pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicializa una nueva instancia de la clase RowUpdatedEventArgs. (Heredado de DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicializa una nueva instancia de la clase RowUpdatingEventArgs. (Heredado de DbDataAdapter)
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. (Heredado de DbDataAdapter)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
ExecuteBatch()	Ejecuta el lote actual. (Heredado de DbDataAdapter)
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. (Heredado de DbDataAdapter)
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 . (Heredado de DbDataAdapter)
Fill(DataSet, Object, String)	Agrega o actualiza las filas de DataSet para que coincidan con las de un objeto o `Record` ADO `Recordset` mediante el objeto , el objeto ADO y el nombre de la tabla de origen especificadosDataSet.
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 DataSetnombres , DataTabley IDataReader . (Heredado de DbDataAdapter)
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 . (Heredado de DbDataAdapter)
Fill(DataSet)	Agrega o actualiza filas en .DataSet (Heredado de DbDataAdapter)
Fill(DataTable, IDataReader)	Agrega o actualiza las filas de para DataTable que coincidan con las del origen de datos mediante los nombres y IDataReader especificadosDataTable. (Heredado de DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Agrega o actualiza las filas de para DataTable que coincidan con las del origen de datos mediante el especificado IDbCommand DataTabley CommandBehavior. (Heredado de DbDataAdapter)
Fill(DataTable, Object)	Agrega o actualiza las filas de para DataTable que coincidan con las de un objeto o `Record` ADO `Recordset` mediante los objetos especificados DataTable y ADO.
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 . (Heredado de DbDataAdapter)
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 . (Heredado de DbDataAdapter)
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. (Heredado de DbDataAdapter)
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. (Heredado de DbDataAdapter)
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. (Heredado de DbDataAdapter)
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. (Heredado de DbDataAdapter)
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. (Heredado de DbDataAdapter)
FillSchema(DataTable, SchemaType)	Configura el esquema del especificado DataTable en función del especificado SchemaType. (Heredado de DbDataAdapter)
GetBatchedParameter(Int32, Int32)	Devuelve un objeto IDataParameter de uno de los comandos del lote actual. (Heredado de DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)	Devuelve información sobre un intento de actualización individual dentro de una actualización por lotes mayor. (Heredado de DbDataAdapter)
GetFillParameters()	Obtiene los parámetros establecidos por el usuario al ejecutar una instrucción SELECT de SQL. (Heredado de DbDataAdapter)
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 (Heredado 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 Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto actual MarshalByRefObject . (Heredado de MarshalByRefObject)
OnFillError(FillErrorEventArgs)	Genera el evento FillError. (Heredado de DbDataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	Genera el `RowUpdated` evento de un proveedor de datos de .NET. (Heredado de DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	Genera el `RowUpdating` evento de un proveedor de datos de .NET. (Heredado de DbDataAdapter)
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 (Heredado de 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. (Heredado de DbDataAdapter)
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. (Heredado de DbDataAdapter)
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 . (Heredado de DbDataAdapter)
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. (Heredado de DbDataAdapter)
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. (Heredado de DbDataAdapter)

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 DbDataAdapter)
RowUpdated	Se produce durante Update(DataSet) después de ejecutar un comando en el origen de datos. Se realiza el intento de actualización. Por lo tanto, se produce el evento .
RowUpdating	Se produce durante Update(DataSet) antes de que se ejecute un comando en el origen de datos. Se realiza el intento de actualización. Por lo tanto, se produce el evento .

Implementaciones de interfaz explícitas

Nombre	Description
ICloneable.Clone()	Para obtener una descripción de este miembro, vea Clone().
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	Para obtener una descripción de este miembro, vea DeleteCommand.
IDbDataAdapter.InsertCommand	Para obtener una descripción de este miembro, vea InsertCommand.
IDbDataAdapter.SelectCommand	Para obtener una descripción de este miembro, vea SelectCommand.
IDbDataAdapter.UpdateCommand	Para obtener una descripción de este miembro, vea UpdateCommand.

Se aplica a

Consulte también

Objetos DataAdapter y DataReader

Comentaris

Us ha resultat útil aquesta pàgina?