OdbcDataAdapter Clase
Definición
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 a un origen de datos que se usan para rellenar DataSet y actualizar el origen de datos. Esta clase no puede heredarse.
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter
type OdbcDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneable
type OdbcDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneable
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
- Herencia
- Implementaciones
Ejemplos
En el ejemplo siguiente se usa OdbcCommand, OdbcDataAdaptery OdbcConnection para seleccionar registros y rellenar un DataSet
con las filas seleccionadas.
public DataSet GetDataSetFromAdapter(
DataSet dataSet, string connectionString, string queryString)
{
using (OdbcConnection connection =
new OdbcConnection(connectionString))
{
OdbcDataAdapter adapter =
new OdbcDataAdapter(queryString, connection);
// Open the connection and fill the DataSet.
try
{
connection.Open();
adapter.Fill(dataSet);
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
// The connection is automatically closed when the
// code exits the using block.
}
return dataSet;
}
Public Function GetDataSetFromAdapter( _
ByVal dataSet As DataSet, ByVal connectionString As String, _
ByVal queryString As String) As DataSet
Using connection As New OdbcConnection(connectionString)
Dim adapter As New OdbcDataAdapter(queryString, connection)
' Open the connection and fill the DataSet.
Try
connection.Open()
adapter.Fill(dataSet)
Catch ex As Exception
Console.WriteLine(ex.Message)
End Try
' The connection is automatically closed when the
' code exits the Using block.
End Using
Return dataSet
End Function
Comentarios
OdbcDataAdapter actúa como un puente entre un DataSet
origen de datos y para recuperar y guardar datos.
OdbcDataAdapter 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.
OdbcDataAdapter Cuando rellena , DataSetcrea las tablas y columnas necesarias 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 OdbcDataAdapter 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.
Nota
Cuando se llama al Fill
método en un origen de datos que no tiene una columna de clave principal, OdbcDataAdapter intenta promover la columna de restricción única a la clave principal. En el proceso, marca OdbcDataAdapter la restricción unique como que no acepta valores NULL. Este comportamiento funciona a menos que haya un valor NULL en la columna de restricción unique. Si hay un valor NULL, el Fill
método produce un error con una infracción de restricción. Para evitar esta situación, no permita valores NULL en la columna de restricción unique.
Nota
Debido a las limitaciones de los controladores ODBC nativos, solo se devuelve uno DataTable al llamar a FillSchema. Esto es cierto incluso cuando se ejecutan instrucciones por lotes de SQL desde las que se esperarían varios DataTable objetos.
OdbcDataAdapter también incluye las propiedades , InsertCommand, DeleteCommand, UpdateCommandy TableMappings
para facilitar la SelectCommandcarga y actualización de datos.
Constructores
OdbcDataAdapter() |
Inicializa una nueva instancia de la clase OdbcDataAdapter. |
OdbcDataAdapter(OdbcCommand) |
Inicializa una nueva instancia de la clase OdbcDataAdapter con la instrucción SQL SELECT especificada. |
OdbcDataAdapter(String, OdbcConnection) |
Inicializa una nueva instancia de la clase OdbcDataAdapter con una instrucción SQL SELECT y OdbcConnection. |
OdbcDataAdapter(String, String) |
Inicializa una nueva instancia de la clase OdbcDataAdapter con una instrucción SQL SELECT y una cadena de conexión. |
Campos
DefaultSourceTableName |
Nombre predeterminado que el objeto DataAdapter utiliza para las asignaciones de tabla. (Heredado de DbDataAdapter) |
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 la instrucción SQL o el procedimiento almacenado utilizado para eliminar registros del origen 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. (Heredado de DbDataAdapter) |
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 una instrucción SQL o procedimiento almacenado utilizado para insertar nuevos registros 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 |
SelectCommand |
Obtiene o establece la instrucción SQL o el procedimiento almacenado utilizado para seleccionar registros del 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. (Heredado de DbDataAdapter) |
UpdateCommand |
Obtiene o establece una instrucción SQL o procedimiento almacenado utilizado para actualizar registros en el origen de datos. |
Métodos
AddToBatch(IDbCommand) |
Agrega una interfaz IDbCommand al lote actual. (Heredado de DbDataAdapter) |
ClearBatch() |
Quita todos los objetos IDbCommand 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 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. (Heredado de DbDataAdapter) |
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping) |
Inicializa una nueva instancia de la clase RowUpdatingEventArgs. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
ExecuteBatch() |
Ejecuta el lote actual. (Heredado de DbDataAdapter) |
Fill(DataSet) |
Agrega o actualiza filas en DataSet. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
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. (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) |
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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
GetBatchedParameter(Int32, Int32) |
Devuelve una interfaz 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 dentro de una actualización más amplia por lotes. (Heredado de DbDataAdapter) |
GetFillParameters() |
Obtiene los parámetros establecidos por el usuario al ejecutar una instrucción SELECT de SQL. (Heredado de DbDataAdapter) |
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. (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 Object actual. (Heredado de Object) |
MemberwiseClone(Boolean) |
Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject) |
OnFillError(FillErrorEventArgs) |
Genera el evento FillError. (Heredado de DbDataAdapter) |
OnRowUpdated(RowUpdatedEventArgs) |
Provoca el evento |
OnRowUpdating(RowUpdatingEventArgs) |
Provoca el evento |
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. (Heredado de 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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
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. (Heredado de DbDataAdapter) |
RowUpdated |
Se produce durante una operación de actualización después de que se ejecute un comando en el origen de datos. |
RowUpdating |
Se produce durante el método Update(DataSet), antes de que se ejecute un comando en el origen de datos. |
Implementaciones de interfaz explícitas
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. |