Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

SqlDataAdapter, classe

Représente un ensemble de commandes de données et une connexion à une base de données qui permettent de remplir DataSet et de 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)

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

Le type SqlDataAdapter expose les membres suivants.

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

  NomDescription
Propriété publiqueAcceptChangesDuringFillObtient ou définit une valeur indiquant si AcceptChanges est appelé sur DataRow après son ajout à DataTable durant les opérations Fill. (Hérité de DataAdapter.)
Propriété publiqueAcceptChangesDuringUpdateObtient ou définit si AcceptChanges est appelé pendant un Update. (Hérité de DataAdapter.)
Propriété publiqueContainerObtient le IContainer qui contient Component. (Hérité de Component.)
Propriété publiqueContinueUpdateOnErrorObtient 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.)
Propriété publiqueDeleteCommandObtient ou définit une instruction Transact-SQL ou une procédure stockée pour supprimer des enregistrements du groupe de données.
Propriété protégéeFillCommandBehaviorObtient ou définit le comportement de la commande utilisée pour remplir l'adaptateur de données. (Hérité de DbDataAdapter.)
Propriété publiqueFillLoadOptionObtient ou définit LoadOption qui détermine comment l'adaptateur remplit DataTable du DbDataReader. (Hérité de DataAdapter.)
Propriété publiqueInsertCommandObtient 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.
Propriété publiqueMissingMappingActionDétermine l'action à effectuer si les données entrantes ne possèdent pas de table ou de colonne correspondante. (Hérité de DataAdapter.)
Propriété publiqueMissingSchemaActionDétermine l'action à effectuer si le schéma DataSet existant ne correspond pas aux données entrantes. (Hérité de DataAdapter.)
Propriété publiqueReturnProviderSpecificTypesObtient 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.)
Propriété publiqueSelectCommandObtient ou définit une instruction Transact-SQL ou une procédure stockée pour sélectionner des enregistrements dans la source de données.
Propriété publiqueSiteObtient ou définit le ISite de Component. (Hérité de Component.)
Propriété publiqueTableMappingsObtient une collection qui fournit le mappage principal entre une table source et DataTable. (Hérité de DataAdapter.)
Propriété publiqueUpdateBatchSizeObtient ou définit le nombre de lignes qui sont traitées lors de chaque aller-retour au serveur. (Substitue DbDataAdapter.UpdateBatchSize.)
Propriété publiqueUpdateCommandObtient ou définit une instruction Transact-SQL ou une procédure stockée pour mettre à jour des enregistrements dans la source de données.
Début

  NomDescription
Méthode publiqueCreateObjRefCré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.)
Méthode publiqueDispose()Libère toutes les ressources utilisées par Component. (Hérité de Component.)
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode publiqueFill(DataSet)Ajoute ou actualise des lignes dans le DataSet. (Hérité de DbDataAdapter.)
Méthode publiqueFill(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.)
Méthode publiqueFill(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.)
Méthode publiqueFill(Int32, Int32, DataTable[])Ajoute ou actualise des lignes dans un DataTable pour établir une correspondance avec celles de la source de données en commençant à l'enregistrement spécifié et en récupérant le nombre maximal d'enregistrements spécifié. (Hérité de DbDataAdapter.)
Méthode publiqueFill(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.)
Méthode publiqueFillSchema(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.)
Méthode publiqueFillSchema(DataTable, SchemaType)Configure le schéma du DataTable spécifié en fonction du SchemaType défini. (Hérité de DbDataAdapter.)
Méthode publiqueFillSchema(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.)
Méthode publiqueGetFillParametersObtient les paramètres définis par l'utilisateur lors de l'exécution d'une instruction SQL SELECT. (Hérité de DbDataAdapter.)
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetLifetimeServiceRé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.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueInitializeLifetimeServiceObtient 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.)
Méthode publiqueResetFillLoadOptionRéinitialise FillLoadOption à son état par défaut et entraîne une réponse de DataAdapter.Fill à AcceptChangesDuringFill. (Hérité de DataAdapter.)
Méthode publiqueShouldSerializeAcceptChangesDuringFillDétermine si la propriété AcceptChangesDuringFill doit être persistante. (Hérité de DataAdapter.)
Méthode publiqueShouldSerializeFillLoadOptionDétermine si la propriété FillLoadOption doit être persistante. (Hérité de DataAdapter.)
Méthode publiqueToStringRetourne String contenant le nom du Component, s'il existe. Cette méthode ne doit pas être substituée. (Hérité de Component.)
Méthode publiqueUpdate(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.)
Méthode publiqueUpdate(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.)
Méthode publiqueUpdate(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.)
Méthode publiqueUpdate(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 DataTable spécifié. (Hérité de DbDataAdapter.)
Début

  NomDescription
Événement publicDisposedSe produit lorsque le composant est supprimé par un appel à la méthode Dispose. (Hérité de Component.)
Événement publicFillErrorRetourné lorsqu'une erreur se produit pendant une opération de remplissage. (Hérité de DataAdapter.)
Événement publicRowUpdatedSe produit pendant une opération de Update, 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.
Événement publicRowUpdatingSe produit pendant une opération de Update, 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.
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeICloneable.ClonePour obtenir une description de ce membre, consultez Clone.
Implémentation d'interface explicitePropriété privéeIDataAdapter.TableMappingsIndique la manière dont une table source est mappée à une table du groupe de données. (Hérité de DataAdapter.)
Implémentation d'interface explicitePropriété privéeIDbDataAdapter.DeleteCommandPour obtenir une description de ce membre, consultez DeleteCommand.
Implémentation d'interface explicitePropriété privéeIDbDataAdapter.InsertCommandPour obtenir une description de ce membre, consultez InsertCommand.
Implémentation d'interface explicitePropriété privéeIDbDataAdapter.SelectCommandPour obtenir une description de ce membre, consultez SelectCommand.
Implémentation d'interface explicitePropriété privéeIDbDataAdapter.UpdateCommandPour obtenir une description de ce membre, consultez UpdateCommand.
Début

SqlDataAdapter sert de lien entre DataSet et SQL Server lors de la récupération et de l'enregistrement de données. SqlDataAdapter établit ce lien en mappant Fill, qui modifie les données de 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 de DataSet, à l'aide des instructions Transact-SQL appropriées par rapport à la source de données. La mise à jour est effectuée ligne par ligne. Pour chaque ligne insérée, modifiée et supprimée, la méthode Update détermine le type de modification qui a été effectuée dessus (Insert, Update ou Delete). En fonction du type de modification, le modèle de commande Insert, Update ou Delete s'exécute pour propager la ligne modifiée à la source de données. Lorsque SqlDataAdapter remplit DataSet, il crée les tables et colonnes nécessaires 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 SqlDataAdapter 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.

SqlDataAdapter est utilisé en association à SqlConnection et à SqlCommand pour optimiser les performances lors d'une connexion à une base de données SQL Server.

RemarqueRemarque

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

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

Lorsqu'une instance de SqlDataAdapter est créée, les valeurs initiales sont affectées aux propriétés de lecture/écriture. Pour obtenir la liste de ces valeurs, consultez le constructeur SqlDataAdapter.

InsertCommand , DeleteCommand et UpdateCommand sont des modèles génériques qui sont remplis automatiquement avec des valeurs individuelles provenant 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é à InsertCommand, UpdateCommand ou DeleteCommand. Le nom de la colonne doit être affecté à la propriété SourceColumn de l'objet DbParameter. Ce paramètre indique que la valeur du paramètre n'est pas définie manuellement, mais est obtenue à partir de la colonne particulière de la ligne actuellement traitée.

RemarqueRemarque

Un InvalidOperationException se produira si la méthode Fill 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 Creating and Using User-Defined Types dans la documentation en ligne de SQL Server.

TopicLocation
Procédure pas à pas : affichage de données hiérarchiques dans un contrôle TreeViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage de données hiérarchiques dans un contrôle TreeViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage de données hiérarchiques dans un contrôle TreeViewGénération d'applications Web ASP.NET dans Visual Studio

L'exemple suivant utilise SqlCommand, SqlDataAdapter et SqlConnection pour sélectionner des enregistrements à partir d'une base de données et remplir un DataSet avec les lignes sélectionnées. Le DataSet rempli est ensuite retourné. Pour effectuer cette opération, un DataSet initialisé, une chaîne de connexion et une chaîne de requête qui est une instruction Transact-SQL SELECT sont passés à la méthode.


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

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft