OdbcDataAdapter Clase

Definición

Espacio de nombres:

System.Data.Odbc

Ensamblado:

System.Data.Odbc.dll

Paquete:

System.Data.Odbc v11.0.0-preview.2.26159.112

Source:

OdbcDataAdapter.cs

Representa un conjunto de comandos de datos y una conexión a un origen de datos que se usan para rellenar y DataSet actualizar el origen de datos. Esta clase no puede heredarse.

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

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

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

Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Herencia

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OdbcDataAdapter

Implementaciones

IDataAdapter IDbDataAdapter ICloneable

Ejemplos

En el ejemplo siguiente se usa OdbcCommand, OdbcDataAdaptery OdbcConnection para seleccionar registros y rellenar con DataSet 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 sirve como 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 de vuelta al origen de datos.

OdbcDataAdapter Cuando rellena un DataSet, crea 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, intenta OdbcDataAdapter promover la columna de restricción única a la clave principal. En el proceso, marca OdbcDataAdapter la restricción única como que no acepta valores NULL. Este comportamiento funciona a menos que haya un valor NULL en la columna de restricción única. Si hay un valor NULL, se produce un error en el Fill método con una infracción de restricción. Para evitar esta situación, no permita valores NULL en la columna de restricción única.

Nota:

Debido a las limitaciones de los controladores ODBC nativos, solo se devuelve uno DataTable cuando se llama 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 SelectCommandpropiedades , InsertCommand, DeleteCommand, UpdateCommand, y TableMappings para facilitar la carga y actualización de datos.

Constructores

Nombre	Description
OdbcDataAdapter()	Inicializa una nueva instancia de la clase OdbcDataAdapter.
OdbcDataAdapter(OdbcCommand)	Inicializa una nueva instancia de la OdbcDataAdapter clase con la instrucción SELECT de SQL especificada.
OdbcDataAdapter(String, OdbcConnection)	Inicializa una nueva instancia de la OdbcDataAdapter clase con una instrucción SELECT de SQL y .OdbcConnection
OdbcDataAdapter(String, String)	Inicializa una nueva instancia de la OdbcDataAdapter clase con una instrucción SELECT de SQL y una cadena de conexión.

Propiedades

Nombre	Description
DeleteCommand	Obtiene o establece una instrucción SQL o un procedimiento almacenado que se usa para eliminar registros en el origen de datos.
InsertCommand	Obtiene o establece una instrucción SQL o un procedimiento almacenado que se usa para insertar registros nuevos en el origen de datos.
SelectCommand	Obtiene o establece una instrucción SQL o un procedimiento almacenado que se usa para seleccionar registros en el origen de datos.
UpdateCommand	Obtiene o establece una instrucción SQL o un procedimiento almacenado que se usa para actualizar los registros del origen de datos.

Eventos

Nombre	Description
RowUpdated	Se produce durante una operación de actualización después de ejecutar un comando en el origen de datos.
RowUpdating	Se produce durante Update(DataSet) antes de que se ejecute un comando en el origen de datos.

Implementaciones de interfaz explícitas

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

Consulte también

• Objetos DataAdapter y DataReader