Configuration de requête TableAdapter (Assistant)

Article
06/10/2015

L'Assistant Configuration de requêtes TableAdapter aide à créer et modifier les requêtes supplémentaires que vous pouvez ajouter aux TableAdapters. Une requête TableAdapter désigne toute requête SQL ou procédure stockée valide qui retourne des données conformes au même schéma que celui de la table de données associée de TableAdapter (ou qui retourne une valeur scalaire). Une fois l'Assistant terminé, une méthode est ajoutée au TableAdapter qui, quand elle est appelée, exécute la requête. (Par exemple, CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle").)

Exécution de l'Assistant

Faites glissez des requêtes dans le Concepteur de DataSet ou configurez les requêtes existantes (toute requête située en dessous de la première requête).

La première requête dans un TableAdapter est la requête principale du TableAdapter. La modification de la requête principale ouvre l'Assistant Configuration de TableAdapter et modifie le schéma de la table de données de TableAdapter. Toutes les requêtes situées sous la requête principale sont des requêtes supplémentaires configurées à l'aide de l'Assistant Configuration de requêtes TableAdapter. Pour plus d'informations sur l'exécution de l'Assistant, consultez Comment : démarrer l'Assistant Configuration de requêtes 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.

Utiliser des instructions SQL

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

Choisir un type de requête

L'Assistant crée plusieurs types de requêtes en fonction des conditions requises de votre application. Vous pouvez choisir des requêtes SELECT qui retournent des lignes de données (une table de données) ou des requêtes SELECT qui retournent une valeur scalaire (une valeur unique telle que Count ou Sum).

Dans la page Choisir un type de requête, sélectionnez le type de requête à créer dans la liste des requêtes disponibles.

Notes

La création d'une instruction INSERT, UPDATE ou DELETE ne remplace pas les commandes de TableAdapter utilisées pour appeler la méthode Update de TableAdapter.Par exemple, si vous sélectionnez UPDATE comme type de requête, vous créez une requête avec un nom que vous spécifiez plus tard dans l'Assistant.Vous exécutez cette requête en appelant cette méthode nommée du TableAdapter.L'appel de la méthode Update de TableAdapter exécute les instructions créées au moment de la configuration du TableAdapter d'origine.

Spécifier une instruction <Query Type> SQL

Dans la page Spécifier une instruction SQL, tapez l'instruction SQL à exécuter à l'appel de la requête.

Conseil

L'Assistant permet d'accéder au Générateur de requêtes, un outil visuel pour créer des requêtes SQL.Pour l'ouvrir, cliquez sur le bouton Générateur de requêtes.

Choisir les méthodes à générer

Cette page présente les options permettant de sélectionner les méthodes que l'Assistant génère pour la requête.

Remplir un DataTable
Crée une méthode pour remplir la table de données. Vous passez le nom de la table de données en tant que paramètre quand vous appelez cette méthode pour remplir la table de données avec les données retournées.

Vous pouvez éventuellement modifier le nom par défaut dans la zone Nom de la méthode. Le choix d'un nom significatif peut être utile quand vous utilisez cette requête dans du code.
Retourner un DataTable
Crée une méthode pour retourner une 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.

Choisir le nom de la fonction

Tapez un nom pour la fonction. La création d'une requête TableAdapter ajoute une méthode au TableAdapter avec le nom fourni ici. Appelez cette méthode pour exécuter la requête. Le choix d'un nom significatif est utile quand vous utilisez cette requête dans du code.

Notes

Quand vous créez des procédures stockées, vous devez fournir deux noms.Le premier nom désigne la procédure stockée créée dans la base de données, le deuxième nom désigne la méthode sur le TableAdapter qui exécute la procédure stockée quand elle est appelée.

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, tapez l'instruction SQL à exécuter quand vous appelez la procédure stockée.

Notes

L'Assistant permet d'accéder au Générateur de requêtes, un outil visuel pour créer des requêtes SQL.Pour l'ouvrir, cliquez sur le bouton Générateur de requêtes.
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 une procédure stockée dans la base de données est déterminée par les paramètres de sécurité pour la base de données spécifique.
La page Afficher les résultats de l'Assistant montre les résultats de la création de la requête 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 des requêtes TableAdapter quand vous sélectionnez l'option Utiliser des procédures stockées existantes.

Sélectionnez une procédure stockée existante dans la liste déroulante de la page Choisir une procédure stockée existante de l'Assistant.

Les Paramètres et Résultats de la procédure stockée sélectionnée sont affichés pour référence.
Cliquez sur Suivant.

Choisir la forme des données retournées par la procédure stockée

Le type des données retournées par la procédure stockée sélectionnée détermine la façon dont l'Assistant crée les méthodes TableAdapter.

Sélectionnez le type des données retournées par cette requête.

Quand vous sélectionnez Données tabulaires, la page Choisir les méthodes à générer (précédemment décrite dans cette page d'aide) s'ouvre, ce qui vous permet de spécifier les types des méthodes, les noms de méthode et la prise en charge de la pagination à créer.
L'option Une valeur unique crée une méthode typée qui retourne une valeur unique. Cette option ouvre la page Choisir le nom de la fonction (précédemment décrite dans cette page d'aide).
L'option Aucune valeur crée une méthode typée qui exécute la procédure stockée et n'attend aucune donnée retournée. Cette option ouvre la page Choisir le nom de la fonction (précédemment décrite dans cette page d'aide).

Afficher les résultats de l'Assistant

La page Afficher les résultats de l'Assistant montre les résultats de la création de la requête TableAdapter. Si l'Assistant rencontre des problèmes, les détails sont affichés dans cette page.

Voir aussi

Partager via