OdbcDataAdapter (Clase)

OdbcDataAdapter sirve de puente entre un DataSet y un origen de datos para recuperar y guardar los datos. La clase OdbcDataAdapter proporciona este puente utilizando el método Fill para cargar datos del origen de datos en la clase DataSet, así como el método Update para devolver los cambios realizados en la clase DataSet al origen de datos.

Cuando OdbcDataAdapter rellene un objeto DataSet, creará las tablas y columnas necesarias para los datos devueltos si todavía no existen. Sin embargo, la información de clave principal no se incluirá en el esquema creado implícitamente a menos que la propiedad MissingSchemaAction se establezca en AddWithKey. También se puede hacer que OdbcDataAdapter cree el esquema de DataSet, incluida la información de clave principal, antes de rellenarlo de datos mediante el método FillSchema. Para obtener más información, vea Agregar restricciones existentes a DataSet.

Nota

Al llamar al método Fill en un origen de datos que no tiene una columna de clave principal, OdbcDataAdapter trata de promover la columna de restricción única a la clave principal. Al hacerlo, OdbcDataAdapter marca la restricción única de manera que no pueda tener un valor nulo. Este comportamiento funciona a menos que haya un valor nulo en la columna de restricción única. Si hay un valor nulo, el método Fill produce un error de infracción de restricción. Para evitar esta situación, no se deben admitir valores nulos en la columna de restricción única.

Nota
Como consecuencia de las limitaciones de los controladores ODBC nativos, al llamar a FillSchema nunca se devuelve más de un DataTable. Esto es así incluso cuando se ejecutan instrucciones SQL por lotes de las que se esperarían varios objetos DataTable.

OdbcDataAdapter incluye también las propiedades SelectCommand, InsertCommand, DeleteCommand, UpdateCommand y TableMappings para facilitar la carga y la actualización de datos.

En el ejemplo siguiente se utiliza OdbcCommand, OdbcDataAdapter y OdbcConnection para seleccionar registros y rellenar un objeto 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;
}

Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework