Aperçu de l'adaptateur de données, boîte de dialogue

Article
08/10/2011

Permet de déterminer de quelle manière les données doivent être remplies dans un groupe de données lorsque l'objet SelectCommand d'un adaptateur est appelé. Avec cette boîte de dialogue, vous pouvez vérifier que l'adaptateur retourne les données attendues, que tous les mappages de table fonctionnent correctement et qu'aucune erreur ne se produit lors du remplissage du groupe de données. Vous pouvez également tester l'effet du passage de différentes valeurs de paramètre à l'adaptateur.

Notes

Dans la version antérieure de Visual Studio, des adaptateurs de données étaient utilisés pour la communication entre applications et bases de données. Même si les adaptateurs de données figurent toujours parmi les principaux composants des Fournisseurs de données .NET Framework (ADO.NET), les TableAdapters sont des composants générés par le concepteur qui simplifient le processus de manipulation des données entre votre application et une base de données. Pour plus d'informations sur l'utilisation de TableAdapters, consultez Vue d'ensemble de TableAdapter.

Il est particulièrement utile d'afficher un aperçu d'un adaptateur de données si vous devez vous en servir pour remplir un groupe de données qui n'a pas été généré directement à partir de cet adaptateur.

La boîte de dialogue apparaît lorsque vous exécutez l'une des actions suivantes :

Quand vous cliquez sur Aperçu des données dans le menu Données. Ce menu est disponible uniquement lorsqu'un adaptateur de données a été ajouté à un formulaire ou un composant.
Quand vous cliquez sur le lien Aperçu des données en bas de la fenêtre Propriétés. Ce lien est disponible lorsque vous affichez les propriétés d'un adaptateur de données.

Liste des éléments d'interface utilisateur

Adaptateurs de données
Répertorie les adaptateurs de données disponibles sur le formulaire ou le composant que vous utilisez actuellement. Sélectionnez l'adaptateur dont vous voulez afficher l'aperçu. Pour afficher les résultats produits par l'utilisation de tous les adaptateurs de données, sélectionnez <Tous les adaptateurs>.
Remplir le groupe de données
Exécute la commande et affiche les données dans la zone Résultats.

Si une erreur se produit pendant que l'adaptateur de données remplit le groupe de données, elle est signalée par un message. Les erreurs possibles sont les suivantes :
- Incompatibilité des types de données.
- Erreurs de syntaxe dans l'instruction SQL ou la procédure stockée en cours d'exécution.
- Erreurs de mappage de table. Par exemple, si les propriétés MissingMappingAction ou MissingSchemaAction d'un adaptateur ont la valeur Error et si les mappages de table ne décrivent pas complètement le traitement à appliquer aux noms de colonnes incompatibles dans la base de données et le groupe de données, une erreur est déclenchée.
- Problèmes de connexion.
Paramètres
Affiche les paramètres requis pour l'instruction SQL SELECT ou la procédure stockée référencée dans l'objet SelectCommand de l'adaptateur ou des adaptateurs de données spécifiés. Si aucun paramètre n'est requis, cette grille est vide.

Chaque paramètre est affiché sous la forme d'une ligne dans la grille avec le nom de paramètre et le type de données rempli. Entrez une valeur pour chaque paramètre dans la zone Valeur. Si le paramètre l'accepte, vous pouvez également sélectionner <PAR DÉFAUT> ou <NULL> dans la liste déroulante de la zone Valeur.
Groupe de données cible
Spécifie le groupe de données que la commande d'aperçu doit remplir. Vous pouvez effectuer une sélection parmi tous les groupes de données disponibles dans votre projet ou choisir de remplir un groupe de données non typé (un groupe de données sans schéma).
Tables de données
Affiche la liste des tables de données dans le groupe de données. Sélectionnez un nom de table pour visualiser les enregistrements remplis par l'adaptateur de données (en général, chaque adaptateur de données remplit une table dans le groupe de données). Si plusieurs tables ont été remplies, vous pouvez en sélectionner une dans la liste afin de visualiser les résultats pour cette table.
Résultats
Affiche les données dans le groupe de données. La zone indique comment les données apparaîtront après avoir été renvoyées de la base de données et après l'application de tous les mappages de table. Les données à l'intérieur de la grille sont en lecture seule.

Si les résultats incluent plusieurs tables, vous pouvez afficher le contenu d'une table spécifique en sélectionnant son nom dans la liste Tables de données.
Effacer les résultats
Efface toutes les données de la table sélectionnée. Pour effacer toutes les tables, sélectionnez-les individuellement dans la liste Tables de données et cliquez sur Effacer les résultats pour chacune d'entre elles.