Comment : ajouter des requêtes globales à un groupe de données

Article
03/04/2013

Les requêtes globales sont des requêtes SQL qui retournent une valeur unique (scalaire) ou aucune valeur.En général, les fonctions globales exécutent des opérations de base de données telles que les insertions, les mises à jour, les suppressions et le regroupement d'informations (par exemple le nombre de clients contenus dans une table ou les charges totales de tous les éléments d'une commande particulière).

Vous pouvez ajouter des requêtes globales en exécutant l'Assistant Configuration de requêtes TableAdapter à partir du Concepteur de DataSet.

[!REMARQUE]

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur de Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Pour ajouter une requête globale à un groupe de données

Ouvrez un groupe de données dans le Concepteur de DataSet.Pour plus d'informations, consultez Comment : ouvrir un groupe de données dans le Concepteur de DataSet.
Faites glisser une Requête depuis l'onglet DataSet de la Boîte à outils jusqu'à une zone vide du Concepteur de DataSet.

La Configuration de requête TableAdapter (Assistant) s'ouvre.
Choisissez une connexion pour la requête à utiliser.Vous pouvez sélectionner une connexion dans la liste ou en créer une nouvelle.Si vous créez une nouvelle connexion, vous pouvez choisir de l'enregistrer dans le fichier de configuration de l'application.Pour plus d'informations, consultez Comment : enregistrer et modifier des chaînes de connexion.
Choisissez s'il convient d'utiliser des instructions SQL ou des procédures stockées.
Choisissez la procédure stockée à utiliser ou, sur la page Choisir un type de requête de l'Assistant, choisissez le type de requête souhaité, puis cliquez sur Suivant.
Spécifiez une requête qui exécute la tâche souhaitée (par exemple, SELECT COUNT(*) AS CustomerCount FROM Customers).

[!REMARQUE]

Si vous faites glisser directement une requête jusqu'au Concepteur de DataSet, une méthode qui ne retournera qu'une valeur scalaire (unique) est créée.Alors que la requête ou la procédure stockée que vous sélectionnez peut retourner plusieurs valeurs, la méthode créée par l'Assistant ne renvoie qu'une seule valeur.Par exemple, la requête peut retourner la première colonne de la première ligne des données retournées.
Une fois l'Assistant terminé, la requête est ajoutée au Concepteur de DataSet.Pour plus d'informations sur l'exécution de la requête, consultez Comment : exécuter des requêtes TableAdapter.