Configuration de TableAdapter (Assistant)

Article
06/10/2015

L'Assistant Configuration de TableAdapter crée et modifie des TableAdapters. L'Assistant crée des TableAdapters basés sur des instructions SQL que vous entrez ou sur des procédures stockées existantes dans la base de données. L'Assistant peut également créer des procédures stockées dans la base de données en fonction des instructions SQL que vous y 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 et remplit un DataTable avec les données retournées par la requête ou procédure stockée. Outre le remplissage des tables de données existantes, les TableAdapters peuvent retourner de nouvelles tables de données déjà remplies. 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 leurs DataTables associés. Pour plus d'informations, consultez Comment : démarrer l'Assistant Configuration de TableAdapter.

Choisir votre connexion de données

Choisissez une connexion existante dans la liste des connexions ou cliquez sur Nouvelle connexion pour créer une connexion à votre base de données.

Quand vous avez terminé d'utiliser la boîte de dialogue Propriétés de connexion, la zone Détails de connexion présente des informations en lecture seule sur le fournisseur sélectionné et 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 fourni par défaut.

L'enregistrement de chaînes de connexion dans le fichier de configuration de l'application simplifie le processus de gestion de votre application en cas de modification de la connexion de base de données. 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. Ainsi, vous n'avez pas besoin de modifier le code source et de 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.Pour réduire le risque d'accès non autorisé à des informations sensibles, pensez à chiffrer vos données.Pour plus d'informations, consultez Chiffrement et déchiffrement de données.

Choisir un type de commande

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

Dans la page Choisir un type de commande, sélectionnez l'une des méthodes suivantes pour extraire les données de la base de données :

L'option Utiliser des instructions SQL vous permet de taper une instruction SQL pour sélectionner les données de votre base de données.
Créer de nouvelles procédures stockées : sélectionnez cette option pour que l'Assistant crée des procédures stockées (dans la base de données) en fonction de 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 aux commandes SELECT, INSERT, UPDATE et DELETE du TableAdapter.

Utiliser des instructions SQL

Cette section décrit comment exécuter l'Assistant Configuration de TableAdapter quand vous sélectionnez l'option Utiliser des instructions SQL.

Dans la page Générer les instructions SQL, tapez l'instruction SQL qui, une fois exécutée, remplira votre table de données.

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

Choisir les méthodes à générer

Cette page présente les options permettant de sélectionner les méthodes du TableAdapter que l'Assistant génère pour extraire et mettre à jour les 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 quand vous appelez 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 la table de données remplie. Dans certaines applications, il semble plus judicieux de retourner une table de données remplie plutôt que de remplir la table de données existante avec des données.

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

Notes

Cette option n'est pas disponible quand l'instruction SQL d'origine ne fournit pas assez d'informations ou que la requête ne peut pas être mise à jour.Cette situation peut se produire, par exemple, dans des requêtes JOIN et des requêtes retournant une valeur unique (scalaire).

Créer des procédures stockées

Cette section décrit comment exécuter l'Assistant Configuration des requêtes TableAdapter quand vous sélectionnez l'option Créer de nouvelles procédures stockées.

Dans la page Générer les procédures stockées, entrez l'instruction SQL qui remplit la table de données. Il s'agit de l'instruction SELECT du TableAdapter, à l'origine de la création des procédures stockées pour la sélection, la mise à jour, l'insertion et la suppression des données.
Dans la page Créer les procédures stockées, procédez comme suit :
1. Tapez un nom pour la nouvelle procédure stockée.
2. Choisissez de créer ou non la procédure stockée dans la base de données sous-jacente.
  
  Notes
  
  La possibilité 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 n'avez pas l'autorisation de créer des 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 montre les résultats de la création du TableAdapter. Si l'Assistant rencontre des problèmes, cette page propose des informations sur l’erreur.

Utiliser des procédures stockées existantes

Cette section décrit comment exécuter l'Assistant Configuration de TableAdapter quand vous sélectionnez 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 quand les méthodes associées sont appelées sur le TableAdapter. Par exemple, la procédure stockée assignée à la commande Update est exécutée quand la méthode TableAdapter.Update() est appelée.

Mappez les paramètres de la procédure stockée sélectionnée aux colonnes correspondantes de la table de données. Par exemple, si votre procédure stockée accepte un paramètre nommé @CompanyName qu'elle passe à la colonne CompanyName de la table, définissez la colonne Source du paramètre @CompanyName sur CompanyName.

Notes

La procédure stockée assignée à la commande SELECT est exécutée en appelant la méthode du TableAdapter que vous nommez à la prochaine étape de l'Assistant.La valeur par défaut est Fill, le code habituel pour exécuter la procédure SELECT est donc TableAdapter.Fill(tableName).Remplacez Fill par le nom choisi pour remplacer la valeur Fill par défaut, le cas échéant, et remplacez « TableAdapter » par le nom réel du TableAdapter (par exemple, CustomersTableAdapter).

Options avancées

Cliquez sur Options avancées pour accéder aux options avancées suivantes du TableAdapter.

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

Quand vous sélectionnez cette option, l'Assistant tente de générer des instructions INSERT, UPDATE et DELETE en fonction de l'instruction SELECT définie dans la page Générer des instructions SQL.
Utiliser l'accès concurrentiel optimiste

Cette option modifie les instructions UPDATE et DELETE pour qu'elles détectent si les enregistrements individuels ont été modifiés depuis leur première lecture dans la table de données. Une exception est levée quand des violations de l'accès concurrentiel sont détectées.
Actualiser le DataTable

Cette option actualise les données de la table une fois les instructions INSERT et UPDATE exécutées.

Étapes suivantes

Une fois l'Assistant terminé, le TableAdapter est ajouté au dataset et peut être affiché et modifié dans le Concepteur de DataSet. Un certain nombre d'étapes peuvent être effectuées ensuite.

Ajouter davantage de TableAdapters. L'Assistant crée un seul TableAdapter. Si vous avez l'intention d'utiliser un dataset contenant plusieurs tables, vous devez ajouter plusieurs TableAdapters à votre dataset.
Ajouter des requêtes supplémentaires au TableAdapter. Pour plus d'informations, consultez Comment : créer des requêtes TableAdapter.
Affichez ce dataset dans la Sources de données (fenêtre) et faites glisser des éléments vers votre ou vos formulaires pour créer des 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