OdbcDataAdapter Classe

Définition

Espace de noms:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Paquet:

System.Data.Odbc v9.0.0-rc.2.24473.5

Source:

OdbcDataAdapter.cs

Représente un jeu de commandes de données et une connexion à une source de données utilisée pour remplir la DataSet et mettre à jour la source de données. Cette classe ne peut pas être héritée.

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

Héritage

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OdbcDataAdapter

Implémente

IDataAdapter IDbDataAdapter ICloneable

Exemples

L’exemple suivant utilise OdbcCommand, OdbcDataAdapteret 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;
}

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

Remarques

Le OdbcDataAdapter sert de pont entre un DataSet et une source de données pour récupérer et enregistrer des données. Le OdbcDataAdapter fournit ce pont à l’aide de Fill pour charger des données de la source de données dans le DataSet, et en utilisant Update pour envoyer des modifications apportées dans le DataSet à la source de données.

Lorsque le OdbcDataAdapter remplit une DataSet, il crée les tables et colonnes requises pour les données retournées s’ils n’existent pas déjà. Toutefois, les informations de clé primaire ne sont pas incluses dans le schéma créé implicitement, sauf si la propriété MissingSchemaAction est définie sur AddWithKey. Vous pouvez également avoir le OdbcDataAdapter créer le schéma de l'DataSet, y compris les informations de clé primaire, avant de le remplir avec des données à l’aide de FillSchema. Pour plus d’informations, consultez Ajout de contraintes existantes à un dataSet.

Note

Lorsque vous appelez la méthode Fill sur une source de données qui n’a pas de colonne de clé primaire, l'OdbcDataAdapter tente de promouvoir la colonne de contrainte unique vers la clé primaire. Dans le processus, le OdbcDataAdapter marque la contrainte unique comme non nullable. Ce comportement fonctionne sauf s’il existe une valeur Null dans la colonne de contrainte unique. S’il existe une valeur Null, la méthode Fill échoue avec une violation de contrainte. Pour éviter cette situation, n’autorisez pas les valeurs Null dans la colonne de contrainte unique.

Note

En raison des limitations des pilotes ODBC natifs, une seule DataTable est jamais retournée lorsque vous appelez FillSchema. Cela est vrai même lors de l’exécution d’instructions de lot SQL à partir desquelles plusieurs objets DataTable seraient attendus.

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

Constructeurs

OdbcDataAdapter()	Initialise une nouvelle instance de la classe OdbcDataAdapter.
OdbcDataAdapter(OdbcCommand)	Initialise une nouvelle instance de la classe OdbcDataAdapter avec l’instruction SQL SELECT spécifiée.
OdbcDataAdapter(String, OdbcConnection)	Initialise une nouvelle instance de la classe OdbcDataAdapter avec une instruction SQL SELECT et une OdbcConnection.
OdbcDataAdapter(String, String)	Initialise une nouvelle instance de la classe OdbcDataAdapter avec une instruction SQL SELECT et une chaîne de connexion.

Champs

DefaultSourceTableName

Nom par défaut utilisé par l’objet DataAdapter pour les mappages de tables. (Hérité de DbDataAdapter)

Propriétés

AcceptChangesDuringFill	Obtient ou définit une valeur indiquant si est appelée sur un après son ajout à l' pendant l’une des opérations de remplissage de remplissage. (Hérité de DataAdapter)
AcceptChangesDuringUpdate	Obtient ou définit si AcceptChanges() est appelée pendant un Update(DataSet). (Hérité de DataAdapter)
CanRaiseEvents	Obtient une valeur indiquant si le composant peut déclencher un événement. (Hérité de Component)
Container	Obtient le IContainer qui contient le Component. (Hérité de Component)
ContinueUpdateOnError	Obtient ou définit une valeur qui spécifie s’il faut générer une exception lorsqu’une erreur est rencontrée lors d’une mise à jour de ligne. (Hérité de DataAdapter)
DeleteCommand	Obtient ou définit une instruction SQL ou une procédure stockée utilisée pour supprimer des enregistrements dans la source de données.
DesignMode	Obtient une valeur qui indique si le Component est actuellement en mode création. (Hérité de Component)
Events	Obtient la liste des gestionnaires d’événements qui sont attachés à cette Component. (Hérité de Component)
FillCommandBehavior	Obtient ou définit le comportement de la commande utilisée pour remplir l’adaptateur de données. (Hérité de DbDataAdapter)
FillLoadOption	Obtient ou définit l'LoadOption qui détermine la façon dont l’adaptateur remplit la DataTable à partir du DbDataReader. (Hérité de DataAdapter)
InsertCommand	Obtient ou définit une instruction SQL ou une procédure stockée utilisée pour insérer de nouveaux enregistrements dans la source de données.
MissingMappingAction	Détermine l’action à entreprendre lorsque les données entrantes n’ont pas de table ou de colonne correspondante. (Hérité de DataAdapter)
MissingSchemaAction	Détermine l’action à entreprendre lorsque le schéma DataSet existant ne correspond pas aux données entrantes. (Hérité de DataAdapter)
ReturnProviderSpecificTypes	Obtient ou définit si la méthode Fill doit retourner des valeurs spécifiques au fournisseur ou des valeurs conformes CLS courantes. (Hérité de DataAdapter)
SelectCommand	Obtient ou définit une instruction SQL ou une procédure stockée utilisée pour sélectionner des enregistrements dans la source de données.
Site	Obtient ou définit la ISite du Component. (Hérité de Component)
TableMappings	Obtient une collection qui fournit le mappage principal entre une table source et un DataTable. (Hérité de DataAdapter)
UpdateBatchSize	Obtient ou définit une valeur qui active ou désactive la prise en charge du traitement par lots et spécifie le nombre de commandes qui peuvent être exécutées dans un lot. (Hérité de DbDataAdapter)
UpdateCommand	Obtient ou définit une instruction SQL ou une procédure stockée utilisée pour mettre à jour les enregistrements dans la source de données.

Méthodes

AddToBatch(IDbCommand)	Ajoute un IDbCommand au lot actuel. (Hérité de DbDataAdapter)
ClearBatch()	Supprime tous les objets IDbCommand du lot. (Hérité de DbDataAdapter)
CloneInternals()	Obsolète. Crée une copie de cette instance de DataAdapter. (Hérité de DataAdapter)
CreateObjRef(Type)	Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Initialise une nouvelle instance de la classe RowUpdatedEventArgs. (Hérité de DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Initialise une nouvelle instance de la classe RowUpdatingEventArgs. (Hérité de DbDataAdapter)
CreateTableMappings()	Crée une DataTableMappingCollection. (Hérité de DataAdapter)
Dispose()	Libère toutes les ressources utilisées par le Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par le DbDataAdapter et libère éventuellement les ressources managées. (Hérité de DbDataAdapter)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
ExecuteBatch()	Exécute le lot actuel. (Hérité de DbDataAdapter)
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Ajoute ou actualise des lignes dans une plage spécifiée dans la DataSet pour les mettre en correspondance avec celles de la source de données à l’aide des noms de table DataSet et de la table source, de la chaîne de commande et du comportement des commandes. (Hérité de DbDataAdapter)
Fill(DataSet, Int32, Int32, String)	Ajoute ou actualise des lignes dans une plage spécifiée dans la DataSet pour les mettre en correspondance dans la source de données à l’aide des noms DataSet et DataTable. (Hérité de DbDataAdapter)
Fill(DataSet, String, IDataReader, Int32, Int32)	Ajoute ou actualise des lignes dans une plage spécifiée dans la DataSet pour les mettre en correspondance dans la source de données à l’aide des noms DataSet, DataTableet IDataReader. (Hérité de DbDataAdapter)
Fill(DataSet, String)	Ajoute ou actualise des lignes dans le DataSet pour les mettre en correspondance dans la source de données à l’aide des noms DataSet et DataTable. (Hérité de DbDataAdapter)
Fill(DataSet)	Ajoute ou actualise des lignes dans le DataSet. (Hérité de DbDataAdapter)
Fill(DataTable, IDataReader)	Ajoute ou actualise des lignes dans un DataTable pour les mettre en correspondance dans la source de données à l’aide des noms DataTable et IDataReader spécifiés. (Hérité de DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Ajoute ou actualise des lignes dans un DataTable pour les mettre en correspondance dans la source de données à l’aide de l'DataTable, IDbCommand et CommandBehaviorspécifiés. (Hérité de DbDataAdapter)
Fill(DataTable)	Ajoute ou actualise des lignes dans une plage spécifiée dans la DataSet pour les mettre en correspondance dans la source de données à l’aide du nom DataTable. (Hérité de DbDataAdapter)
Fill(DataTable[], IDataReader, Int32, Int32)	Ajoute ou actualise des lignes dans une plage spécifiée dans la collection d’objets DataTable pour les mettre en correspondance dans la source de données. (Hérité de DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	Ajoute ou actualise des lignes dans une plage spécifiée dans la DataSet pour les mettre en correspondance dans la source de données à l’aide des noms DataSet et DataTable. (Hérité de DbDataAdapter)
Fill(Int32, Int32, DataTable[])	Ajoute ou actualise des lignes dans un ou plusieurs objets DataTable pour qu’ils correspondent à ceux de la source de données commençant à l’enregistrement spécifié et récupérant jusqu’au nombre maximal spécifié d’enregistrements. (Hérité de DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	Ajoute un DataTable au DataSet spécifié et configure le schéma pour qu’il corresponde à celui dans la source de données en fonction du SchemaTypespécifié. (Hérité de DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)	Ajoute un DataTable au DataSetspécifié. (Hérité de DataAdapter)
FillSchema(DataSet, SchemaType, String)	Ajoute un DataTable au DataSet spécifié et configure le schéma pour qu’il corresponde à celui dans la source de données en fonction des SchemaType et DataTablespécifiés. (Hérité de DbDataAdapter)
FillSchema(DataSet, SchemaType)	Ajoute un DataTable nommé « Table » au DataSet spécifié et configure le schéma pour qu’il corresponde à celui dans la source de données en fonction du SchemaTypespécifié. (Hérité de DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)	Ajoute un DataTable au DataSetspécifié. (Hérité de DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Configure le schéma du DataTable spécifié en fonction des valeurs SchemaType, chaîne de commande et CommandBehavior spécifiées. (Hérité de DbDataAdapter)
FillSchema(DataTable, SchemaType)	Configure le schéma du DataTable spécifié en fonction de la SchemaTypespécifiée. (Hérité de DbDataAdapter)
GetBatchedParameter(Int32, Int32)	Retourne une IDataParameter de l’une des commandes du lot actuel. (Hérité de DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)	Retourne des informations sur une tentative de mise à jour individuelle au sein d’une mise à jour par lots plus grande. (Hérité de DbDataAdapter)
GetFillParameters()	Obtient les paramètres définis par l’utilisateur lors de l’exécution d’une instruction SQL SELECT. (Hérité de DbDataAdapter)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetService(Type)	Renvoie un objet qui représente un service fourni par l'Component ou par son Container. (Hérité de Component)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
HasTableMappings()	Indique si un DataTableMappingCollection a été créé. (Hérité de DataAdapter)
InitializeBatching()	Initialise le traitement par lots pour le DbDataAdapter. (Hérité de DbDataAdapter)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l’objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
OnFillError(FillErrorEventArgs)	Déclenche l’événement FillError. (Hérité de DbDataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	Déclenche l’événement RowUpdated d’un fournisseur de données .NET. (Hérité de DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	Déclenche l’événement RowUpdating d’un fournisseur de données .NET. (Hérité de DbDataAdapter)
ResetFillLoadOption()	Réinitialise FillLoadOption à son état par défaut et provoque Fill(DataSet) respecter AcceptChangesDuringFill. (Hérité de DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Détermine si la propriété AcceptChangesDuringFill doit être conservée. (Hérité de DataAdapter)
ShouldSerializeFillLoadOption()	Détermine si la propriété FillLoadOption doit être conservée. (Hérité de DataAdapter)
ShouldSerializeTableMappings()	Détermine si un ou plusieurs objets DataTableMapping existent et qu’ils doivent être conservés. (Hérité de DataAdapter)
TerminateBatching()	Termine le traitement par lot pour le DbDataAdapter. (Hérité de DbDataAdapter)
ToString()	Retourne un String contenant le nom du Component, le cas échéant. Cette méthode ne doit pas être remplacée. (Hérité de Component)
Update(DataRow[], DataTableMapping)	Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans le tableau spécifié d’objets DataRow. (Hérité de DbDataAdapter)
Update(DataRow[])	Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans le tableau spécifié dans le DataSet. (Hérité de DbDataAdapter)
Update(DataSet, String)	Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans le DataSet avec le nom de DataTable spécifié. (Hérité de DbDataAdapter)
Update(DataSet)	Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans la DataSetspécifiée. (Hérité de DbDataAdapter)
Update(DataTable)	Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans la DataTablespécifiée. (Hérité de DbDataAdapter)

Événements

Disposed	Se produit lorsque le composant est supprimé par un appel à la méthode Dispose(). (Hérité de Component)
FillError	Retourné lorsqu’une erreur se produit pendant une opération de remplissage. (Hérité de DbDataAdapter)
RowUpdated	Se produit pendant une opération de mise à jour après l’exécution d’une commande sur la source de données.
RowUpdating	Se produit pendant Update(DataSet) avant l’exécution d’une commande sur la source de données.

Implémentations d’interfaces explicites

ICloneable.Clone()	Pour obtenir une description de ce membre, consultez Clone().
IDataAdapter.TableMappings	Obtient une collection qui indique comment une table source est mappée à une table de jeu de données. (Hérité de DataAdapter)
IDbDataAdapter.DeleteCommand	Pour obtenir une description de ce membre, consultez DeleteCommand.
IDbDataAdapter.InsertCommand	Pour obtenir une description de ce membre, consultez InsertCommand.
IDbDataAdapter.SelectCommand	Pour obtenir une description de ce membre, consultez SelectCommand.
IDbDataAdapter.UpdateCommand	Pour obtenir une description de ce membre, consultez UpdateCommand.

Voir aussi

• DataAdapters et DataReaders