OleDbDataAdapter Classe

Définition

Espace de noms:: System.Data.OleDb

Assembly:: System.Data.OleDb.dll

Assembly:: System.Data.dll

Paquet:: System.Data.OleDb v11.0.0-preview.2.26159.112

Source:: OleDbDataAdapter.cs

Source:: OleDbDataAdapter.cs

Source:: OleDbDataAdapter.cs

Source:: OleDbDataAdapter.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente un jeu de commandes de données et une connexion de base de données utilisée pour remplir et DataSet mettre à jour la source de données.

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

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter

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

public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

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

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

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter

Héritage: Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter
OleDbDataAdapter

Attributs: RequiresDynamicCodeAttribute

Implémente: IDataAdapter IDbDataAdapter ICloneable

Exemples

L’exemple suivant utilise , OleDbCommand OleDbDataAdapter et OleDbConnection, pour sélectionner des enregistrements à partir d’une source de données Access, puis remplir un DataSet avec les lignes sélectionnées. Le remplissage DataSet est ensuite retourné. Pour ce faire, la méthode passe une chaîne de connexion initialisée DataSet, une chaîne de connexion et une chaîne de requête qui est une instruction SQL SELECT.

public static OleDbDataAdapter CreateDataAdapter(string selectCommand,
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter(selectCommand, connection);

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the Insert, Update and Delete commands.
    adapter.InsertCommand = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)");

    adapter.UpdateCommand = new OleDbCommand(
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?");

    adapter.DeleteCommand = new OleDbCommand(
        "DELETE FROM Customers WHERE CustomerID = ?");

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}

Public Function CreateDataAdapter(ByVal selectCommand As String, _
    ByVal connection As OleDbConnection) As OleDbDataAdapter

    Dim adapter As OleDbDataAdapter = _
        New OleDbDataAdapter(selectCommand, connection)

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey

    ' Create the commands.
    adapter.InsertCommand = New OleDbCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
         "VALUES (?, ?)")

    adapter.UpdateCommand = New OleDbCommand( _
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?")

    adapter.DeleteCommand = New OleDbCommand( _
        "DELETE FROM Customers WHERE CustomerID = ?")

    ' Create the parameters.
    adapter.InsertCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.InsertCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.UpdateCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.UpdateCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")
    adapter.UpdateCommand.Parameters.Add( _
        "@oldCustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    adapter.DeleteCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    Return adapter
End Function

Remarques

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

Lorsque le OleDbDataAdapter remplissage est rempli DataSet, il crée les tables et colonnes appropriées 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 MissingSchemaAction propriété est définie AddWithKeysur . Vous pouvez également avoir le OleDbDataAdapter schéma du schéma , DataSety compris les informations de clé primaire, avant de le remplir avec des données à l’aide FillSchemade . Pour plus d’informations, consultez Ajout de contraintes existantes à un DataSet.

Notez que certains fournisseurs OLE DB, y compris le fournisseur MSDataShape, ne retournent pas de table de base ni d’informations sur la clé primaire. Par conséquent, la OleDbDataAdapter propriété ne peut pas définir correctement la PrimaryKey propriété sur n’importe quel élément créé DataTable. Dans ces cas, vous devez spécifier explicitement des clés primaires pour les tables dans le DataSet.

Il OleDbDataAdapter inclut également les SelectCommandpropriétés , , UpdateCommand InsertCommand DeleteCommandet TableMappings les propriétés pour faciliter le chargement et la mise à jour des données.

Lorsque vous créez une instance de OleDbDataAdapter, les propriétés sont définies sur leurs valeurs initiales. Pour obtenir la liste de ces valeurs, consultez le OleDbDataAdapter constructeur.

Constructeurs

Nom	Description
OleDbDataAdapter()	Initialise une nouvelle instance de la classe OleDbDataAdapter.
OleDbDataAdapter(OleDbCommand)	Initialise une nouvelle instance de la OleDbDataAdapter classe avec la propriété spécifiée OleDbCommand SelectCommand .
OleDbDataAdapter(String, OleDbConnection)	Initialise une nouvelle instance de la OleDbDataAdapter classe avec un SelectCommand.
OleDbDataAdapter(String, String)	Initialise une nouvelle instance de la OleDbDataAdapter classe avec un SelectCommand.

Champs

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

Propriétés

Nom	Description
AcceptChangesDuringFill	Obtient ou définit une valeur indiquant si AcceptChanges() elle est appelée après DataRow son ajout à l’une DataTable des opérations de remplissage . (Hérité de DataAdapter)
AcceptChangesDuringUpdate	Obtient ou définit si AcceptChanges() elle 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 fichier 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 pour supprimer des enregistrements du jeu de données.
DesignMode	Obtient une valeur qui indique si la Component valeur est actuellement en mode création. (Hérité de Component)
Events	Obtient la liste des gestionnaires d’événements qui sont attachés à ce 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’élément LoadOption qui détermine la façon dont l’adaptateur remplit l’adaptateur 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 existant DataSet ne correspond pas aux données entrantes. (Hérité de DataAdapter)
ReturnProviderSpecificTypes	Obtient ou définit si la `Fill` méthode doit retourner des valeurs spécifiques au fournisseur ou des valeurs compatibles 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 le ISite 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

Nom	Description
AddToBatch(IDbCommand)	Ajoute un IDbCommand lot actuel. (Hérité de DbDataAdapter)
ClearBatch()	Supprime tous les IDbCommand objets du lot. (Hérité de DbDataAdapter)
CloneInternals()	Obsolète. Obsolète. Obsolète. 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 un nouveau 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 les DbDataAdapter ressources gérées 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 les lignes d’une plage spécifiée dans la DataSet plage pour qu’elles correspondent à celles de la source de données à l’aide des DataSet noms de 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 plage pour qu’elles correspondent à celles de la source de données à l’aide des noms et DataTable des DataSet noms. (Hérité de DbDataAdapter)
Fill(DataSet, Object, String)	Ajoute ou actualise des lignes dans le DataSet but de les mettre en correspondance dans un objet ou `Record` ADO `Recordset` à l’aide du nom de DataSettable source, objet ADO et spécifié.
Fill(DataSet, String, IDataReader, Int32, Int32)	Ajoute ou actualise des lignes dans une plage spécifiée dans la DataSet plage pour qu’elles correspondent à celles de la source de données à l’aide des noms et IDataReader des DataSet DataTablenoms. (Hérité de DbDataAdapter)
Fill(DataSet, String)	Ajoute ou actualise des lignes dans le DataSet pour qu’elles correspondent à celles de la source de données à l’aide des noms et DataTable des DataSet noms. (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 qu’elles correspondent à celles de la source de données à l’aide des noms et IDataReader des noms spécifiésDataTable. (Hérité de DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Ajoute ou actualise des lignes dans un DataTable pour qu’elles correspondent à celles de la source de données à l’aide des éléments spécifiés DataTableet IDbCommand CommandBehavior. (Hérité de DbDataAdapter)
Fill(DataTable, Object)	Ajoute ou actualise des lignes dans un DataTable objet ou `Record` ado `Recordset` pour les mettre en correspondance à l’aide des objets ADO et ADO spécifiésDataTable.
Fill(DataTable)	Ajoute ou actualise des lignes dans une plage spécifiée dans la DataSet plage pour qu’elles correspondent à celles de la source de données à l’aide du DataTable nom. (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 pour les mettre en correspondance dans la source de DataTable 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 plage pour qu’elles correspondent à celles de la source de données à l’aide des noms et DataTable des DataSet noms. (Hérité de DbDataAdapter)
Fill(Int32, Int32, DataTable[])	Ajoute ou actualise des lignes dans un ou plusieurs DataTable objets pour les mettre en correspondance dans la source de données à partir de l’enregistrement spécifié et récupérer jusqu’au nombre maximal spécifié d’enregistrements. (Hérité de DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	Ajoute un DataTable au schéma spécifié DataSet et configure le schéma pour qu’il corresponde à celui dans la source de données en fonction de l’élément spécifié SchemaType. (Hérité de DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)	Ajoute un DataTable à l’objet spécifié DataSet. (Hérité de DataAdapter)
FillSchema(DataSet, SchemaType, String)	Ajoute un DataTable au schéma spécifié DataSet et configure le schéma pour qu’il corresponde à celui dans la source de données en fonction de l’élément spécifié SchemaType et DataTable. (Hérité de DbDataAdapter)
FillSchema(DataSet, SchemaType)	Ajoute une DataTable « table » nommée au schéma spécifié DataSet et configure le schéma pour qu’il corresponde à celui dans la source de données en fonction de l’élément spécifié SchemaType. (Hérité de DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)	Ajoute un DataTable à l’objet spécifié DataSet. (Hérité de DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Configure le schéma de l’objet DataTable spécifié en fonction de la chaîne de commande et CommandBehavior des valeurs spécifiéesSchemaType. (Hérité de DbDataAdapter)
FillSchema(DataTable, SchemaType)	Configure le schéma de l’objet spécifié DataTable en fonction de l’objet spécifié SchemaType. (Hérité de DbDataAdapter)
GetBatchedParameter(Int32, Int32)	Retourne une IDataParameter commande 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)	Retourne un objet qui représente un service fourni par le 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 actuel MarshalByRefObject . (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) l’honneur AcceptChangesDuringFill. (Hérité de DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Détermine si la AcceptChangesDuringFill propriété doit être conservée. (Hérité de DataAdapter)
ShouldSerializeFillLoadOption()	Détermine si la FillLoadOption propriété doit être conservée. (Hérité de DataAdapter)
ShouldSerializeTableMappings()	Détermine si un ou plusieurs DataTableMapping objets 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 nom 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 d’objets DataRow spécifié. (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 nom spécifié DataTable . (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 ligne spécifiée DataSet. (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 ligne spécifiée DataTable. (Hérité de DbDataAdapter)

Événements

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

Implémentations d’interfaces explicites

Nom	Description
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.

S’applique à

Voir aussi

DataAdapters et DataReaders

Commentaires

Cette page a-t-elle été utile ?