OdbcDataAdapter, classe

OdbcDataAdapter joue le rôle de pont entre DataSet et une source de données pour la récupération et l'enregistrement de données. OdbcDataAdapter fournit ce pont en utilisant Fill pour charger les données à partir de la source de données dans DataSet et en utilisant Update pour renvoyer à la source de données les modifications apportées à DataSet.

Lorsque OdbcDataAdapter remplit un DataSet, il crée les tables et colonnes requises pour les données retournées si elles n'existent pas encore. Cependant, les informations de clés primaires ne sont pas incluses dans le schéma créé implicitement, à moins que la propriété MissingSchemaAction ait la valeur AddWithKey. Vous pouvez également laisser OdbcDataAdapter créer le schéma de DataSet, comprenant les informations de clés primaires, avant de le remplir avec les données à l'aide de FillSchema. Pour plus d'informations, consultez Ajout de contraintes existantes à un DataSet (ADO.NET).

Remarque :

Lorsque vous appelez la méthode Fill sur une source de données qui ne possède pas de colonne de clés primaires, OdbcDataAdapter tente de promouvoir la colonne contrainte unique vers la clé primaire. Au cours de ce processus, OdbcDataAdapter marque la contrainte unique comme n'admettant pas une valeur null. Ce comportement fonctionne, sauf si une valeur null figure dans la colonne contrainte unique. Si une valeur null est présente, la méthode Fill échoue en raison d'une violation de contrainte. Pour éviter cette situation, n'autorisez pas les valeurs null dans la colonne contrainte unique.

Remarque :
Compte tenu des limitations des pilotes ODBC natifs, un seul DataTable est retourné quand vous appelez FillSchema. Cela est vrai lorsque vous exécutez des instructions SQL regroupées par lots à partir desquelles plusieurs objets DataTable peuvent être attendus.

OdbcDataAdapter comprend également les propriétés SelectCommand, InsertCommand, DeleteCommand, UpdateCommand et TableMappings pour faciliter le chargement et la mise à jour des données.

L'exemple suivant utilise OdbcCommand, OdbcDataAdapter et OdbcConnection pour sélectionner des enregistrements et remplir un DataSet avec les lignes sélectionnées.

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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Référence

Autres ressources