SqlDataAdapter Classe

Définition

Espace de noms:

System.Data.SqlClient

Assembly:

System.Data.dll

Représente un ensemble de commandes de données et une connexion de base de données qui sont utilisées pour remplir le DataSet et mettre à jour une base de données SQL Server. Cette classe ne peut pas être héritée.

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

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

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

Public NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Héritage

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

SqlDataAdapter

Implémente

IDataAdapter IDbDataAdapter ICloneable

Exemples

L’exemple suivant utilise , SqlCommandSqlDataAdapteret SqlConnection pour sélectionner des enregistrements à partir d’une base de données et remplir un DataSet avec les lignes sélectionnées. Le rempli DataSet est ensuite retourné. Pour ce faire, la méthode est transmise à une chaîne initialisée DataSet, une chaîne de connexion et une chaîne de requête qui est une instruction SELECT Transact-SQL.

private static DataSet SelectRows(DataSet dataset,
    string connectionString,string queryString)
{
    using (SqlConnection connection =
        new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter();
        adapter.SelectCommand = new SqlCommand(
            queryString, connection);
        adapter.Fill(dataset);
        return dataset;
    }
}

Public Function SelectRows( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New SqlConnection(connectionString)
        Dim adapter As New SqlDataAdapter()
        adapter.SelectCommand = New SqlCommand( _
            queryString, connection)
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function

Remarques

, SqlDataAdaptersert de pont entre un DataSet et SQL Server pour récupérer et enregistrer des données. Fournit SqlDataAdapter ce pont en mappant Fill, qui modifie les données dans le DataSet pour qu’elles correspondent aux données de la source de données, et Update, qui modifie les données de la source de données pour qu’elles correspondent aux données dans , à l’aide DataSetdes instructions Transact-SQL appropriées par rapport à la source de données. La mise à jour est effectuée par ligne. Pour chaque ligne insérée, modifiée et supprimée, la Update méthode détermine le type de modification qui a été effectuée sur celle-ci (Insert, Updateou Delete). Selon le type de modification, le Insertmodèle de commande , Updateou Delete s’exécute pour propager la ligne modifiée à la source de données. Lorsque le SqlDataAdapter remplit un DataSet, il crée les tables et colonnes nécessaires pour les données retournées si elles 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é a la MissingSchemaAction valeur AddWithKey. Vous pouvez également créer le SqlDataAdapter schéma de , y compris les informations de clé primaire, avant de le remplir de données à l’aide DataSetFillSchemade . Pour plus d’informations, consultez Ajout de contraintes existantes à un DataSet.

SqlDataAdapterest utilisé conjointement avec SqlConnection et SqlCommand pour augmenter les performances lors de la connexion à une base de données SQL Server.

Notes

Si vous utilisez des procédures stockées SQL Server pour modifier ou supprimer des données à l'aide de DataAdapter, assurez-vous que vous n'utilisez pas SET NOCOUNT ON dans la définition de procédure stockée. En effet, le nombre de lignes affectées retourné serait alors la valeur zéro, ce que DataAdapter interprète comme un conflit d'accès concurrentiel. Dans ce cas, l'exception DBConcurrencyException est levée.

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

Lorsqu’une instance de SqlDataAdapter est créée, les propriétés en lecture/écriture sont définies sur les valeurs initiales. Pour obtenir la liste de ces valeurs, consultez le SqlDataAdapter constructeur.

DeleteCommand, InsertCommandet UpdateCommand sont des modèles génériques qui sont automatiquement remplis avec des valeurs individuelles de chaque ligne modifiée via le mécanisme des paramètres.

Pour chaque colonne que vous propagez vers la source de données sur Update, un paramètre doit être ajouté au InsertCommand, UpdateCommandou DeleteCommand. La SourceColumn propriété de l’objet DbParameter doit être définie sur le nom de la colonne. Ce paramètre indique que la valeur du paramètre n’est pas définie manuellement, mais est extraite de la colonne particulière de la ligne actuellement traitée.

Notes

Un InvalidOperationException se produit si la Fill méthode est appelée et que la table contient un type défini par l’utilisateur qui n’est pas disponible sur l’ordinateur client. Pour plus d’informations, consultez Types CLR définis par l’utilisateur.

Constructeurs

SqlDataAdapter()	Initialise une nouvelle instance de la classe SqlDataAdapter.
SqlDataAdapter(SqlCommand)	Initialise une nouvelle instance de la classe SqlDataAdapter avec le SqlCommand spécifié en tant que propriété SelectCommand.
SqlDataAdapter(String, SqlConnection)	Initialise une nouvelle instance de la classe SqlDataAdapter avec SelectCommand et un objet SqlConnection.
SqlDataAdapter(String, String)	Initialise une nouvelle instance de la classe SqlDataAdapter avec SelectCommand et une chaîne de connexion.

Champs

DefaultSourceTableName

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

Propriétés

AcceptChangesDuringFill	Obtient ou définit une valeur indiquant si AcceptChanges() est appelé sur un DataRow après son ajout à DataTable au cours de l’une des opérations Fill. (Hérité de DataAdapter)
AcceptChangesDuringUpdate	Obtient ou définit si AcceptChanges() est appelé pendant un Update(DataSet). (Hérité de DataAdapter)
CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
Container	Obtient le IContainer qui contient la Component. (Hérité de Component)
ContinueUpdateOnError	Obtient ou définit une valeur qui spécifie si une exception doit être générée en cas d'erreur pendant la mise à jour d'une ligne. (Hérité de DataAdapter)
DeleteCommand	Obtient ou définit une instruction Transact-SQL ou une procédure stockée pour supprimer des enregistrements du groupe de données.
DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
Events	Obtient la liste des gestionnaires d'événements 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 LoadOption qui détermine comment l'adaptateur remplit DataTable du DbDataReader. (Hérité de DataAdapter)
InsertCommand	Obtient ou définit une instruction Transact-SQL ou une procédure stockée pour insérer de nouveaux enregistrements dans la source de données.
MissingMappingAction	Détermine l'action à effectuer si les données entrantes ne possèdent pas de table ou de colonne correspondante. (Hérité de DataAdapter)
MissingSchemaAction	Détermine l'action à effectuer si 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 communes conformes CLS. (Hérité de DataAdapter)
SelectCommand	Obtient ou définit une instruction Transact-SQL ou une procédure stockée pour sélectionner des enregistrements dans la source de données.
Site	Obtient ou définit le ISite de 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 le nombre de lignes qui sont traitées lors de chaque aller-retour au serveur.
UpdateCommand	Obtient ou définit une instruction Transact-SQL ou une procédure stockée pour mettre à jour des enregistrements dans la source de données.

Méthodes

AddToBatch(IDbCommand)	Ajoute 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 contenant toutes les informations appropriées requises pour générer un proxy permettant de 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 DataTableMappingCollection. (Hérité de DataAdapter)
Dispose()	Libère toutes les ressources utilisées par Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par 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)	Ajoute ou actualise des lignes dans le DataSet. (Hérité de DbDataAdapter)
Fill(DataSet, Int32, Int32, String)	Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour qu'elles correspondent à celles de la source de données en utilisant les noms DataSet et DataTable. (Hérité de DbDataAdapter)
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour qu'elles correspondent à celles de la source de données en utilisant DataSet et les noms de tables source, la chaîne de commande et le comportement des commandes. (Hérité de DbDataAdapter)
Fill(DataSet, String)	Ajoute ou actualise les lignes de DataSet pour qu'elles correspondent à celles de la source de données en utilisant les 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 de DataSet pour les faire correspondre à celles de la source de données en utilisant les noms DataSet, DataTable et IDataReader. (Hérité de DbDataAdapter)
Fill(DataTable)	Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour qu'elles correspondent à celles de la source de données, en utilisant le nom DataTable. (Hérité de DbDataAdapter)
Fill(DataTable, IDataReader)	Ajoute ou actualise les lignes d’un DataTable pour les faire correspondre dans la source de données en utilisant les noms DataTable et IDataReader spécifiés. (Hérité de DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Ajoute ou actualise les lignes de DataTable pour établir une correspondance avec celles de la source de données à l'aide des DataTable, IDbCommand et CommandBehavior spécifiés. (Hérité de DbDataAdapter)
Fill(DataTable[], IDataReader, Int32, Int32)	Ajoute ou actualise des lignes d'une plage spécifiée de la collection d'objets DataTable pour qu'elles correspondent à celles de 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 de DataSet pour qu'elles correspondent à celles de la source de données en utilisant les noms DataSet et DataTable. (Hérité de DbDataAdapter)
Fill(Int32, Int32, DataTable[])	Ajoute ou actualise les lignes d’un ou plusieurs DataTable objets pour qu’elles correspondent à celles de la source de données en commençant à l’enregistrement spécifié et en récupérant jusqu’au nombre maximal d’enregistrements spécifié. (Hérité de DbDataAdapter)
FillSchema(DataSet, SchemaType)	Ajoute un DataTable appelé "Table" au DataSet spécifié et configure le schéma pour qu'il corresponde à celui de la source de données en se basant sur le SchemaType spécifié. (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 de la source de données en se basant sur le SchemaType défini. (Hérité de DbDataAdapter)
FillSchema(DataSet, SchemaType, String)	Ajoute un DataTable au DataSet spécifié et configure le schéma pour qu'il corresponde à celui de la source de données en se basant sur les SchemaType et DataTable définis. (Hérité de DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)	Ajoute DataTable au DataSet spécifié. (Hérité de DataAdapter)
FillSchema(DataTable, SchemaType)	Configure le schéma du DataTable spécifié en fonction du SchemaType défini. (Hérité de DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)	Ajoute DataTable au DataSet spécifié. (Hérité de DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Configure le schéma du DataTable spécifié en fonction du SchemaType, de la chaîne de commande et des valeurs CommandBehavior définis. (Hérité de DbDataAdapter)
GetBatchedParameter(Int32, Int32)	Retourne IDataParameter à partir de l'une des commandes du lot actuel. (Hérité de DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)	Retourne les informations relatives à une tentative de mise à jour distincte dans le cadre plus large d'une mise à jour groupée. (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()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Récupère l'objet de service de durée de vie en cours 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 Component ou par son Container. (Hérité de Component)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
HasTableMappings()	Indique si DataTableMappingCollection a été créé. (Hérité de DataAdapter)
InitializeBatching()	Initialise le mode batch pour DbDataAdapter. (Hérité de DbDataAdapter)
InitializeLifetimeService()	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 Object actuel. (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 entraîne une réponse de Fill(DataSet) à AcceptChangesDuringFill. (Hérité de DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Détermine si la propriété AcceptChangesDuringFill doit être persistante. (Hérité de DataAdapter)
ShouldSerializeFillLoadOption()	Détermine si la propriété FillLoadOption doit être persistante. (Hérité de DataAdapter)
ShouldSerializeTableMappings()	Détermine si un ou plusieurs objets DataTableMapping existent et s'ils doivent être persistants. (Hérité de DataAdapter)
TerminateBatching()	Termine le mode batch pour DbDataAdapter. (Hérité de DbDataAdapter)
ToString()	Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée. (Hérité de Component)
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 DataSet. (Hérité de DbDataAdapter)
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(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 le DataSet spécifié. (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 DataSet avec le nom DataTable spécifié. (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 le DataTable spécifié. (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 Update(DataSet), après l'exécution d'une commande sur la source de données. La tentative de mise à jour provoque le déclenchement de l'événement.
RowUpdating	Se produit pendant une opération de Update(DataSet), avant l'exécution d'une commande sur la source de données. La tentative de mise à jour provoque le déclenchement de l'événement.

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
• Manipulation de données (ADO.NET)
• Vue d'ensemble d’ADO.NET