Assistant Configuration de requêtes TableAdapter

Article
08/21/2008

Mise à jour : novembre 2007

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

Exécution de l'Assistant

Faites glisser des requêtes jusqu'au Concepteur de DataSet ou configurez des requêtes existantes (toute requête répertoriée sous la première requête).

La première requête contenue dans un TableAdapter est la requête principale de ce dernier. La modification de cette requête principale entraîne l'ouverture de l'Assistant Configuration de TableAdapter et modifie le schéma de la table de données du TableAdapter. Toutes les requêtes répertoriées sous la requête principale sont des requêtes supplémentaires et sont 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

Sélectionnez une connexion existante dans la liste des connexions ou cliquez sur Nouvelle connexion pour ouvrir la boîte de dialogue Ajouter/Modifier la connexion (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 : modifier une chaîne 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.

Utiliser des instructions SQL

Cette section explique comment exécuter l'Assistant Configuration de requêtes TableAdapter lors de la sélection de l'option Utiliser des instructions SQL.

Choisir un type de requête

L'Assistant crée plusieurs types de requêtes selon les exigences 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 des valeurs scalaires (une valeur unique, telle que Count ou Sum).

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

Remarque :
La création d'une instruction INSERT, UPDATE ou DELETE ne remplace pas les commandes du TableAdapter qui sont utilisées lors de l'appel à sa méthode Update. Par exemple, la sélection de UPDATE comme type de requête entraîne la création d'une nouvelle requête portant un nom que vous spécifierez ultérieurement dans l'Assistant. Pour exécuter cette requête, vous devez appeler cette méthode nommée du TableAdapter. L'appel à la méthode Update du TableAdapter exécute les instructions créées lors de la configuration originale du TableAdapter.

La création d'une instruction INSERT, UPDATE ou DELETE ne remplace pas les commandes du TableAdapter qui sont utilisées lors de l'appel à sa méthode Update. Par exemple, la sélection de UPDATE comme type de requête entraîne la création d'une nouvelle requête portant un nom que vous spécifierez ultérieurement dans l'Assistant. Pour exécuter cette requête, vous devez appeler cette méthode nommée du TableAdapter. L'appel à la méthode Update du TableAdapter exécute les instructions créées lors de la configuration originale du TableAdapter.

Spécifier une instruction <Type de requête> SQL

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

Conseil :
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.

Choisir les méthodes à générer

Cette page contient des 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 devez passer le nom de la table de données en tant que paramètre lors de l'appel à 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. Fournir un nom explicite peut être utile si 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 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.

Choisir le nom de la fonction

Tapez le nom de la fonction. La création d'une requête TableAdapter ajoute au TableAdapter une méthode portant le nom spécifié ici. Appelez cette méthode pour exécuter la requête. Fournir un nom explicite peut être utile si vous utilisez cette requête dans du code.

Remarque :
Lorsque vous créez de nouvelles procédures stockées, deux noms vous sont demandés. Le premier est le nom de la procédure stockée créée dans la base de données ; le deuxième est le nom de la méthode sur le TableAdapter qui exécute la procédure stockée lors de son appel.

Créer de nouvelles procédures stockées

Cette section explique comment exécuter l'Assistant Configuration de requêtes TableAdapter lors de la sélection de 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 lors de l'appel de la procédure stockée.

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 une procédure stockée dans la base de données est déterminée par les paramètres de sécurité de la base de données spécifique.
La page Afficher les résultats de l'Assistant affiche les résultats de la création de la requête TableAdapter. Si l'Assistant rencontre des problèmes, cette page fournit des informations sur l'erreur.

Remarque :
La capacité 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é de la base de données spécifique.

Utiliser des procédures stockées existantes

Cette section explique comment exécuter l'Assistant Configuration de requêtes TableAdapter lors de la sélection de 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 les Résultats de la procédure stockée sélectionnée sont affichés à titre de référence.
Cliquez sur Suivant.

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

Le type de données retourné par la procédure stockée sélectionnée détermine la manière dont l'Assistant crée les méthodes TableAdapter.

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

Si vous sélectionnez Données sous forme de tableau, la page Choisir les méthodes à générer (décrite plus haut sur cette page d'aide) qui vous permet de spécifier les types de méthodes, les noms des méthodes et la prise en charge du fichier d'échange à créer.
Si vous sélectionnez Valeur unique, une méthode typée qui retourne une valeur unique est créée. Cette option ouvre la page Choisir le nom de la fonction (décrite plus haut sur cette page d'aide).
Si vous sélectionnez Aucune valeur, une méthode typée qui exécute la procédure stockée et qui n'attend le retour d'aucune donnée est créée. Cette option ouvre la page Choisir le nom de la fonction (décrite plus haut sur cette page d'aide).

Afficher les résultats de l'Assistant

La page Afficher les résultats de l'Assistant affiche 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 sur cette page.

Voir aussi