Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

SqlDataAdapter classe

 

Date de publication : novembre 2016

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.

Espace de noms:   System.Data.SqlClient
Assembly:  System.Data (dans System.Data.dll)

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DataAdapter
        System.Data.Common.DbDataAdapter
          System.Data.SqlClient.SqlDataAdapter

public sealed class SqlDataAdapter : DbDataAdapter, IDbDataAdapter, 
	IDataAdapter, ICloneable

NomDescription
System_CAPS_pubmethodSqlDataAdapter()

Initialise une nouvelle instance de la classe SqlDataAdapter.

System_CAPS_pubmethodSqlDataAdapter(SqlCommand)

Initialise une nouvelle instance de la SqlDataAdapter classe avec l’objet SqlCommand comme le SelectCommand propriété.

System_CAPS_pubmethodSqlDataAdapter(String, SqlConnection)

Initialise une nouvelle instance de la SqlDataAdapter classe avec un SelectCommand et un SqlConnection objet.

System_CAPS_pubmethodSqlDataAdapter(String, String)

Initialise une nouvelle instance de la SqlDataAdapter classe avec un SelectCommand et une chaîne de connexion.

NomDescription
System_CAPS_pubpropertyAcceptChangesDuringFill

Obtient ou définit une valeur qui indique si AcceptChanges est appelée sur un DataRow après son ajout à la DataTable au cours de la remplir operations.(Hérité de DataAdapter.)

System_CAPS_pubpropertyAcceptChangesDuringUpdate

Obtient ou définit si AcceptChanges est appelé pendant un Update.(Hérité de DataAdapter.)

System_CAPS_pubpropertyContainer

Obtient les IContainer qui contient la Component.(Hérité de Component.)

System_CAPS_pubpropertyContinueUpdateOnError

Obtient ou définit une valeur qui spécifie si pour générer une exception lorsqu’une erreur est rencontrée lors d’une mise à jour de la ligne.(Hérité de DataAdapter.)

System_CAPS_pubpropertyDeleteCommand

Obtient ou définit une instruction Transact-SQL ou une procédure stockée pour supprimer des enregistrements dans le jeu de données.

System_CAPS_protpropertyFillCommandBehavior

Obtient ou définit le comportement de la commande utilisée pour remplir l’adaptateur de données.(Hérité de DbDataAdapter.)

System_CAPS_pubpropertyFillLoadOption

Obtient ou définit le LoadOption qui détermine comment l’adaptateur remplit le DataTable à partir de la DbDataReader.(Hérité de DataAdapter.)

System_CAPS_pubpropertyInsertCommand

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.

System_CAPS_pubpropertyMissingMappingAction

Détermine l’action à entreprendre lorsque les données entrantes ne dispose pas d’une table ou une colonne correspondante.(Hérité de DataAdapter.)

System_CAPS_pubpropertyMissingSchemaAction

Détermine l’action à entreprendre lorsqu’un DataSet schéma ne correspond pas aux données entrantes.(Hérité de DataAdapter.)

System_CAPS_pubpropertyReturnProviderSpecificTypes

Obtient ou définit si la Fill méthode doit retourner des valeurs spécifiques au fournisseur ou des valeurs communes conformes à CLS.(Hérité de DataAdapter.)

System_CAPS_pubpropertySelectCommand

Obtient ou définit une instruction Transact-SQL ou une procédure stockée utilisée pour sélectionner des enregistrements dans la source de données.

System_CAPS_pubpropertySite

Obtient ou définit le ISite de la Component.(Hérité de Component.)

System_CAPS_pubpropertyTableMappings

Obtient une collection qui fournit le mappage principal entre une table source et un DataTable.(Hérité de DataAdapter.)

System_CAPS_pubpropertyUpdateBatchSize

Obtient ou définit le nombre de lignes traitées dans chaque aller-retour au serveur.(Remplace DbDataAdapter.UpdateBatchSize.)

System_CAPS_pubpropertyUpdateCommand

Obtient ou définit une instruction Transact-SQL ou une procédure stockée utilisée pour mettre à jour des enregistrements dans la source de données.

NomDescription
System_CAPS_pubmethodCreateObjRef(Type)

Crée un objet qui contient toutes les informations requises pour générer un proxy permettant de communiquer avec un objet distant.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodDispose()

Libère toutes les ressources utilisées par Component.(Hérité de Component.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodFill(DataSet)

Ajoute ou actualise des lignes dans la DataSet.(Hérité de DbDataAdapter.)

System_CAPS_pubmethodFill(DataSet, Int32, Int32, String)

Ajoute ou actualise des lignes dans une plage spécifiée dans le DataSet correspondre à ceux de la source de données à l’aide de la DataSet et DataTable noms.(Hérité de DbDataAdapter.)

System_CAPS_pubmethodFill(DataSet, String)

Ajoute ou actualise des lignes dans la DataSet correspondre à ceux de la source de données à l’aide de la DataSet et DataTable noms.(Hérité de DbDataAdapter.)

System_CAPS_pubmethodFill(DataTable)

Ajoute ou actualise des lignes dans une plage spécifiée dans le DataSet correspondre à ceux de la source de données en utilisant le DataTable nom.(Hérité de DbDataAdapter.)

System_CAPS_pubmethodFill(Int32, Int32, DataTable[])

Ajoute ou actualise des lignes dans un DataTable correspondre à ceux de la source de données commençant à l’enregistrement spécifié et en récupérant le nombre maximal spécifié d’enregistrements.(Hérité de DbDataAdapter.)

System_CAPS_pubmethodFillSchema(DataSet, SchemaType)

Ajoute un DataTable nommé « Table » au DataSet spécifié et configure le schéma pour qu’il corresponde à celui de la source de données en fonction du SchemaType spécifié.(Hérité de DbDataAdapter.)

System_CAPS_pubmethodFillSchema(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 fonction du SchemaType et du DataTable spécifiés.(Hérité de DbDataAdapter.)

System_CAPS_pubmethodFillSchema(DataTable, SchemaType)

Configure le schéma du DataTable spécifié en fonction du SchemaType spécifié.(Hérité de DbDataAdapter.)

System_CAPS_pubmethodGetFillParameters()

Obtient les paramètres définis par l’utilisateur lors de l’exécution d’une instruction SQL SELECT.(Hérité de DbDataAdapter.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetLifetimeService()

Récupère l’objet de service de durée de vie actuelle qui contrôle la stratégie de durée de vie de cette instance.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodInitializeLifetimeService()

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.)

System_CAPS_pubmethodResetFillLoadOption()

Réinitialise FillLoadOption à son état par défaut et les causes DataAdapter.Fill à honorer AcceptChangesDuringFill.(Hérité de DataAdapter.)

System_CAPS_pubmethodShouldSerializeAcceptChangesDuringFill()

Détermine si le AcceptChangesDuringFill propriété doit être persistante.(Hérité de DataAdapter.)

System_CAPS_pubmethodShouldSerializeFillLoadOption()

Détermine si le FillLoadOption propriété doit être persistante.(Hérité de DataAdapter.)

System_CAPS_pubmethodToString()

Retourne un String contenant le nom de la Component, le cas échéant. Cette méthode ne doit pas être remplacée.(Hérité de Component.)

System_CAPS_pubmethodUpdate(DataRow[])

Met à jour les valeurs dans la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque inséré, mis à jour ou supprimé la ligne du tableau spécifié dans le DataSet.(Hérité de DbDataAdapter.)

System_CAPS_pubmethodUpdate(DataSet)

Met à jour les valeurs dans la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque insérés, mis à jour ou supprimé des lignes dans la DataSet.(Hérité de DbDataAdapter.)

System_CAPS_pubmethodUpdate(DataSet, String)

Met à jour les valeurs dans la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque inséré, mis à jour ou supprimer des lignes dans le DataSet avec l’objet DataTable nom.(Hérité de DbDataAdapter.)

System_CAPS_pubmethodUpdate(DataTable)

Met à jour les valeurs dans la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque insérés, mis à jour ou supprimé des lignes dans la DataTable.(Hérité de DbDataAdapter.)

NomDescription
System_CAPS_pubeventDisposed

Se produit lorsque le composant est supprimé par un appel à la Dispose (méthode).(Hérité de Component.)

System_CAPS_pubeventFillError

Retourné lorsqu’une erreur se produit pendant une opération de remplissage.(Hérité de DataAdapter.)

System_CAPS_pubeventRowUpdated

Se produit au cours de Update après une commande est exécutée sur la source de données. La tentative de mise à jour est effectuée, donc l’événement est déclenché.

System_CAPS_pubeventRowUpdating

Se produit au cours de Update avant une commande est exécutée sur la source de données. La tentative de mise à jour est effectuée, donc l’événement est déclenché.

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodICloneable.Clone()

Pour obtenir une description de ce membre, consultez Clone.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataAdapter.TableMappings

Indique la manière dont une table source est mappée à une table de dataset.(Hérité de DataAdapter.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbDataAdapter.DeleteCommand

Pour obtenir une description de ce membre, consultez DeleteCommand.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbDataAdapter.InsertCommand

Pour obtenir une description de ce membre, consultez InsertCommand.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbDataAdapter.SelectCommand

Pour obtenir une description de ce membre, consultez SelectCommand.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbDataAdapter.UpdateCommand

Pour obtenir une description de ce membre, consultez UpdateCommand.

Le SqlDataAdapter, sert de pont entre une DataSet et SQL Server pour récupérer et enregistrer des données. Le SqlDataAdapter fournit ce pont en mappant Fill, qui modifie les données dans le DataSet pour faire correspondre les données dans la source de données, et Update, qui modifie les données dans la source de données pour faire correspondre les données dans le DataSet, à l’aide des instructions Transact-SQL sur la source de données. La mise à jour est effectuée sur une base 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 dessus (Insert, Update, ou Delete). Selon le type de modification, le Insert, Update, ou Delete modèle de commande 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 MissingSchemaAction est définie sur AddWithKey. Vous devrez peut-être également le SqlDataAdapter créer le schéma de la DataSet, y compris les informations de clé primaire, avant de le remplir avec des données à l’aide FillSchema. Pour plus d'informations, consultez Ajout de contraintes existantes à un DataSet.

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

System_CAPS_noteRemarque

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.

La SqlDataAdapter inclut également le SelectCommand, InsertCommand, DeleteCommand, UpdateCommand, et TableMappings Propriétés afin de faciliter le chargement et la mise à jour des données.

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

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

Pour chaque colonne que vous propagez à la source de données sur Update, un paramètre doit être ajouté à la InsertCommand, UpdateCommand, ou DeleteCommand. Le SourceColumn propriété de la DbParameter objet doit être défini 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.

System_CAPS_noteRemarque

Un InvalidOperationException se produira si le Fill méthode est appelée et la table contient un type défini par l’utilisateur qui n’est pas disponible sur l’ordinateur client. Pour plus d’informations, consultez Creating and Using User-Defined Types dans la documentation en ligne de SQL Server.

L’exemple suivant utilise le SqlCommand, SqlDataAdapter, et SqlConnection pour sélectionner des enregistrements dans une base de données et remplir un DataSet avec les lignes sélectionnées. La pleine DataSet est alors retournée. Pour ce faire, est passé à la méthode initialisé DataSet, une chaîne de connexion et une chaîne de requête qui est une instruction Transact-SQL SELECT.

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;
    }
}

.NET Framework
Disponible depuis 1.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: