Configuration de TableAdapter (Assistant)

Article
03/04/2013

L'Assistant Configuration de TableAdapter crée et modifie des TableAdapters.Cet Assistant crée des TableAdapters en fonction des instructions SQL que vous entrez ou des procédures stockées existantes dans la base de données.L'Assistant peut également créer de nouvelles procédures stockées dans la base de données selon les instructions SQL que vous entrez.

Un TableAdapter se connecte à une base de données, exécute des requêtes ou des procédures stockées sur une base de données, puis remplit un DataTable avec les données retournées par la requête ou la procédure stockée.Outre le remplissage de tables de données existantes avec des données, les TableAdapters peuvent retourner de nouvelles tables de données remplies de données.Pour plus d'informations, consultez Vue d'ensemble de TableAdapter.

Exécution de l'Assistant

Exécutez l'Assistant pour créer ou modifier des TableAdapters et les DataTables qui leur sont associés.Pour plus d'informations, consultez Comment : démarrer l'Assistant Configuration de TableAdapter.

Choisir votre connexion de données

Sélectionnez une connexion existante dans la liste des connexions ou cliquez sur Nouvelle connexion pour ouvrir la Ajouter/Modifier une connexion, boîte de dialogue (Général) et créer une connexion à votre base de données.

Une fois la boîte de dialogue Propriétés de connexion terminée, la zone Détails de connexion affiche des informations en lecture seule sur le fournisseur sélectionné ainsi que sur la chaîne de connexion.

Enregistrer la chaîne de connexion dans le fichier de configuration de l'application

Choisissez Oui, enregistrer la connexion en tant que pour stocker la chaîne de connexion dans le fichier de configuration de l'application.Tapez un nom pour la connexion ou utilisez le nom par défaut fourni.

L'enregistrement des chaînes de connexion dans le fichier de configuration de l'application simplifie le processus de maintenance de votre application si la connexion de base de données est modifiée.En cas de modification de la connexion de base de données, vous pouvez modifier la chaîne de connexion dans le fichier de configuration de l'application.De cette manière, vous ne devez pas modifier le code source et recompiler votre application.Pour plus d'informations sur la modification d'une chaîne de connexion dans le fichier de configuration de l'application, consultez Comment : enregistrer et modifier des chaînes de connexion.

Note de sécurité
Les informations sont stockées dans le fichier de configuration de l'application sous forme de texte brut.Il est possible de chiffrer vos données pour réduire le risque d'accès non autorisé aux informations sensibles.Pour plus d'informations, consultez Chiffrement et déchiffrement de données.

Choisissez un type de commande

Choisissez le type de commande à exécuter sur la base de données.

Sur la page Choisissez un type de commande, sélectionnez l'une des méthodes d'extraction de données de la base de données suivantes :

Utiliser des instructions SQL : permet de taper une instruction SQL pour sélectionner les données dans votre base de données.
Créer de nouvelles procédures stockées : sélectionnez cette option pour que l'Assistant crée de nouvelles procédures stockées (dans la base de données) basées sur l'instruction SELECT spécifiée.
Utiliser des procédures stockées existantes : sélectionnez cette option pour mapper des procédures stockées qui existent déjà dans votre base de données à des commandes SELECT, INSERT, UPDATE et DELETE du TableAdapter.

Utiliser des instructions SQL

Cette section explique comment exécuter l'Assistant Configuration de TableAdapter lorsque l'option Utiliser des instructions SQL est sélectionnée.

Sur la page Générer les instructions SQL, tapez l'instruction SQL qui, lorsqu'elle sera exécutée, remplira de données votre table de données.

[!REMARQUE]

L'Assistant donne accès au Générateur de requêtes (outil visuel permettant de créer des requêtes SQL).Pour le lancer, cliquez sur le bouton Générateur de requêtes.Pour plus d'informations sur l'utilisation du Générateur de requêtes, consultez Outils du Concepteur de requêtes et de vues.

La page Afficher les résultats de l'Assistant affiche les résultats de la création du TableAdapter.Si l'Assistant rencontre des problèmes, cette page fournit des informations sur l'erreur.

Choisir les méthodes à générer

Cette page propose des options permettant de sélectionner les méthodes TableAdapter que l'Assistant doit générer pour extraire et mettre à jour des données.

Remplir un DataTable
Crée la méthode par défaut du TableAdapter pour remplir la table de données.Passez le nom de la table de données en tant que paramètre lors de l'appel de cette méthode.

Vous pouvez éventuellement modifier le nom par défaut dans la zone Nom de la méthode.
Retourner un DataTable
Crée la méthode du TableAdapter pour retourner une table de données remplie.Dans certaines applications, il peut être préférable de retourner une table de données remplie plutôt que de remplir de données la table de données existante.

Vous pouvez éventuellement modifier le nom par défaut dans la zone Nom de la méthode.
Créer des méthodes pour envoyer directement des mises à jour à la base de données
Crée les commandes INSERT, UPDATE et DELETE nécessaires pour écrire des modifications dans la base de données sous-jacente.La sélection de cette zone équivaut à définir la propriété GenerateDBDirectMethods avec la valeur true.

[!REMARQUE]

Cette option n'est pas disponible si l'instruction SQL d'origine ne fournit pas suffisamment d'informations ou si la requête n'est pas une requête modifiable.Par exemple, cette situation peut se produire dans des requêtes JOIN et dans des requêtes retournant une valeur unique (scalaire).

Créer de nouvelles procédures stockées

Cette section explique comment exécuter l'Assistant Configuration de TableAdapter lors de la sélection de l'option Créer de nouvelles procédures stockées.

Sur la page Générer les procédures stockées, entrez l'instruction SQL qui remplit la table de données.Il s'agira de l'instruction SELET du TableAdapter qui sert de base à la création des procédures stockées pour la sélection, la mise à jour, l'insertion et la suppression de données.

[!REMARQUE]

L'Assistant donne accès au Générateur de requêtes (outil visuel permettant de créer des requêtes SQL).Pour le lancer, cliquez sur le bouton Générateur de requêtes.Pour plus d'informations sur l'utilisation du Générateur de requêtes, consultez Outils du Concepteur de requêtes et de vues ou appuyez sur F1 dans cette boîte de dialogue.
Sur la page Créer les procédures stockées, procédez comme suit :
1. Tapez le nom de la nouvelle procédure stockée.
2. Spécifiez s'il convient de créer la procédure stockée dans la base de données sous-jacente.
  
  [!REMARQUE]
  
  La capacité de créer des procédures stockées dans la base de données est déterminée par les paramètres de sécurité et les autorisations de la base de données spécifique.Par exemple, si vous ne disposez pas de l'autorisation de créer de nouvelles procédures stockées dans la base de données, cette option ne peut pas être exécutée.
La page Afficher les résultats de l'Assistant affiche les résultats de la création du TableAdapter.Si l'Assistant rencontre des problèmes, cette page fournit des informations sur l'erreur.

Utiliser des procédures stockées existantes

Cette section explique comment exécuter l'Assistant Configuration de TableAdapter lors de la sélection de l'option Utiliser des procédures stockées existantes.

Lier des commandes à des procédures stockées existantes

Sélectionnez la procédure stockée à exécuter pour les commandes SELECT, INSERT, UPDATE et DELETE du TableAdapter.Ces procédures stockées sont exécutées lors de l'appel des méthodes associées sur le TableAdapter.Par exemple, la procédure stockée assignée à la commande Update est exécutée lors de l'appel à la méthode TableAdapter.Update().

Mappez des paramètres de la procédure stockée sélectionnée aux colonnes correspondantes dans la table de données.Par exemple, si votre procédure stockée accepte un paramètre nommé @CompanyName qu'il passe à la colonne CompanyName dans la table, affectez à l'option Colonne source du paramètre @CompanyName la valeur CompanyName.

[!REMARQUE]

La procédure stockée assignée à la commande SELECT est exécutée lors de l'appel à la méthode du TableAdapter que vous nommerez à l'étape suivante de l'Assistant.La valeur par défaut est Fill afin que le code standard d'exécution de la procédure SELECT soit TableAdapter.Fill(tableName).Remplacez Fill par le nom de votre choix si vous souhaitez remplacer la valeur par défaut (Fill), puis remplacez « TableAdapter » par le nom réel du TableAdapter (par exemple, CustomersTableAdapter).

Options avancées

Cliquer sur Options avancées permet d'accéder aux options avancées suivantes du TableAdapter.

Générer des instructions Insert, Update et Delete

Lorsque vous sélectionnez cette option, l'Assistant tente de générer des instructions INSERT, UPDATE et DELETE basées sur l'instruction SELECT définie sur la page Générer les instructions SQL.
Utiliser l'accès concurrentiel optimiste

La sélection de cette option modifie les instructions UPDATE et DELETE pour détecter si des enregistrements individuels ont été modifiés depuis leur lecture originale dans la table de données.Une exception est levée lorsque des violations de l'accès concurrentiel sont détectées.
Actualiser la table de données

La sélection de cette option actualise les données dans la table après l'exécution des instructions INSERT et UPDATE.

Étapes suivantes

Une fois l'Assistant terminé, le TableAdapter est ajouté au groupe de données et peut être affiché et modifié dans le Concepteur de DataSet.Vous pouvez ensuite effectuer plusieurs opérations,

ajouter davantage de TableAdapters.L'Assistant crée un TableAdapter.Si vous prévoyez d'utiliser un groupe de données qui contient plusieurs tables, vous voudrez probablement ajouter d'autres TableAdapters à votre groupe de données.
ajouter des requêtes supplémentaires au TableAdapter.Pour plus d'informations, consultez Comment : créer des requêtes TableAdapter.
Consultez ce groupe de données dans la Sources de données (fenêtre) et faites glisser les éléments sur vos formulaires afin de créer les contrôles liés aux données.Pour plus d'informations, consultez Liaison de contrôles Windows Forms à des données dans Visual Studio.

Voir aussi