Affichez et modifiez les valeurs des variables avec les infobulles dans l'éditeur de code.
Cet article explore comment travailler avec la fonctionnalité DataTips dans Visual Studio. Les info-bulles de données constituent un moyen pratique d'afficher des informations sur les variables de votre programme pendant que vous déboguez votre code. Lorsque vous définissez des points d'arrêt dans votre code et que vous commencez le débogage, les info-bulles de données sont visibles pour les variables lorsqu'elles entrent dans la portée actuelle de l'exécution. Vous pouvez utiliser l'info-bulle de données pour modifier la valeur d'une variable dans la portée et réexécuter le code au-dessus du point d'arrêt pour voir l'effet de la modification.
Conseil
Si vous êtes novice en matière de débogage, vous pouvez lire Débogage pour les débutants absolus et Techniques et outils de débogage avant de lire cet article.
Prérequis
Visual Studio. Si vous n’avez pas Visual Studio, accédez à la page Téléchargements de Visual Studio pour l’installer gratuitement.
Un code de programme à exécuter dans le débogueur de Visual Studio.
Utiliser les datatips
Des info-bulles de données sont visibles au cours d'une session de débogage lorsque des points d'arrêt sont définis dans votre code. Lorsque le débogueur interrompt l'exécution du programme à un point d'arrêt, des info-bulles de données sont disponibles pour toutes les variables de la portée actuelle.
Le processus est le suivant :
Définissez un point d'arrêt dans votre code et démarrez le débogage en sélectionnant Débogage>Démarrer le débogage ou en utilisant le raccourci clavier F5.
Lorsque le débogueur interrompt l'exécution au point d'arrêt, survolez n'importe quelle variable de la portée actuelle pour ouvrir l'info-bulle de données.
Utilisez l'info-bulle des données pour voir le nom de la variable et travailler avec la valeur.
Si nécessaire, modifiez la valeur d'une variable ou ajoutez des commentaires.
Remarque
Visual Studio évalue et affiche la valeur de la variable dans une info-bulle de données en fonction du contexte dans lequel le débogueur est mis en pause lors de l'exécution. L'évaluation n'est pas basée sur l'emplacement actuel du curseur ou de l'info-bulle de données. Si vous survolez une variable dans une autre fonction qui porte le même nom qu'une variable dans le contexte actuel, Visual Studio affiche la valeur de la variable dans l'info-bulle de données pour le contexte actuel.
Visual Studio prend en charge de nombreuses actions pour les info-bulles de données et le travail avec les variables et les valeurs, notamment :
- Épingler ou faire flotter une info-bulle de données pour qu'elle reste visible pendant que l'exécution du code se poursuit.
- Activer des info-bulles de données collantes qui restent développées jusqu'à ce que vous les sélectionniez ailleurs.
- Développez l'info-bulle des données d'un tableau, d'une structure ou d'un objet pour afficher ses membres sous forme d'arbre.
- Modifier la valeur d'une variable dans une info-bulle de données
- Ajouter des commentaires multilignes à une info-bulle de données épinglée pour prendre des notes pendant le débogage
- Importation et exportation de datatips
Rendre les info-bulles de données transparentes
Lorsque vous survolez une variable pour afficher l'info-bulle des données, vous pouvez rendre l'info-bulle des données transparente pour voir le code en dessous. Cette action active également la transparence pour d'autres actions de l'éditeur de code, telles que les définitions de méthodes et la syntaxe des expressions.
Pour activer la transparence, procédez comme suit
Dans l'éditeur Visual Studio Code, sélectionnez à l'intérieur d'une info-bulle de données, puis sélectionnez et maintenez la touche Ctrl enfoncée.
Pour maintenir la transparence, maintenez la touche Ctrl enfoncée.
Pour mettre fin à la transparence, arrêtez de sélectionner Ctrl ou sélectionnez ailleurs.
La transparence n'est pas disponible pour une info-bulle de données épinglée ou flottante.
Conserver les info-bulles de données développées
Dans Visual Studio 2022 Update 1 et les versions ultérieures, lorsque vous développez une info-bulle de données, vous pouvez la laisser développée jusqu'à ce que vous fassiez une autre sélection. Cette action produit une info-bulle de données collante.
Pour rendre une info-bulle de données collante, procédez comme suit :
Dans Visual Studio, sélectionnez Débogage>Options pour ouvrir la boîte de dialogue Options.
Dans l'onglet Général, faites défiler l'écran pour trouver l'option Garder les info-bulles développées des données ouvertes jusqu'à ce que vous cliquiez ailleurs.
Cochez la case pour activer l'option collante, puis sélectionnez OK.
Lorsque l'option collante est activée, si vous développez une info-bulle de données dans l'éditeur de code, elle reste développée.
Épingler des datatips
Vous pouvez épingler une info-bulle de données pour la garder ouverte sur la surface de l'éditeur de code. Vous pouvez également modifier l'emplacement de l'info-bulle de données épinglée.
Pour épingler une info-bulle de données, procédez comme suit :
Dans l'éditeur Visual Studio Code, survolez une variable pour afficher l'info-bulle des données.
Dans l'info-bulle des données, utilisez la punaise pour sélectionner Épingler à la source :
Visual Studio épingle l'info-bulle des données à un endroit proche de la variable sur la surface du code. Une punaise apparaît dans la gouttière de l'éditeur de code à côté de la ligne où vous avez épinglé l'info-bulle de données.
Sélectionnez et faites glisser l'info-bulle de données épinglée à n'importe quel endroit de la surface de l'éditeur de code.
Flotter (désépingler) les info-bulles de données
Après avoir épinglé une info-bulle de données, vous pouvez la désépingler et la faire flotter. Une info-bulle de données flottante peut être positionnée n'importe où dans l'IDE Visual Studio.
Pour faire flotter une info-bulle de données, procédez comme suit :
Dans une info-bulle de données épinglée, utilisez la punaise pour sélectionner Désépingler de la source.
Visual Studio désépingle l'info-bulle de données et lui donne un arrière-plan de couleur unie. La punaise de l'info-bulle de données est désépinglée et la punaise dans la gouttière de l'éditeur de code est supprimée.
Sélectionnez et faites glisser l'info-bulle flottante de données à n'importe quel endroit de l'IDE Visual Studio.
Si vous positionnez l'info-bulle flottante des données en dehors de la surface de l'éditeur de code, la punaise est supprimée du menu latéral de l'info-bulle des données. L'option Épingler à la source n'est disponible que lorsque l'info-bulle flottante des données est positionnée sur la surface de l'éditeur de code.
Repincer les info-bulles de données
Après avoir fait flotter une info-bulle de données, vous pouvez l'épingler à un emplacement source spécifique sur la surface de l'éditeur de code.
Pour réafficher une info-bulle flottante de données, procédez comme suit :
Sélectionnez et déplacez l'info-bulle flottante des données, puis positionnez-la sur la surface de l'éditeur de code.
Dans l'info-bulle flottante des données, utilisez la punaise pour sélectionner Épingler à la source.
La punaise prend la position épinglée. L'info-bulle des données est épinglée à un emplacement spécifique dans l'éditeur de code et une punaise pour la source apparaît dans la gouttière de l'éditeur de code.
Fermer les info-bulles de données
Il existe plusieurs façons de fermer les info-bulles de données dans Visual Studio.
Lorsque vous terminez votre session de débogage, si des info-bulles de données sont ouvertes, Visual Studio les ferme pour vous. Si vous lancez une autre session de débogage, Visual Studio tente de rétablir les info-bulles de données que vous avez précédemment laissées ouvertes.
Le tableau suivant résume la manière dont vous pouvez fermer manuellement les info-bulles de données :
| Fermer la cible | Action |
|---|---|
| Info-bulle de données spécifique | Sélectionnez le X dans l'info-bulle des données. |
| Toutes les info-bulles de données pour un fichier spécifique | Sélectionnez Débogage>Effacer toutes les info-bulles des données épinglées sur <Nom de fichier> dans la barre d'outils de Visual Studio. |
| Toutes les info-bulles de données ouvertes | Sélectionnez Débogage>Effacer toutes les info-bulles de données dans la barre d'outils de Visual Studio. |
Travailler avec des variables et des valeurs dans les info-bulles de données
Lorsque vous travaillez avec des infobulles de données dans Visual Studio, vous avez la possibilité de voir des détails sur les variables et les objets, et de modifier les valeurs pendant le débogage. Ces fonctionnalités sont utiles pour dépanner rapidement et tester les modifications apportées à votre code.
Développez les objets dans les info-bulles de données pour en afficher les membres
Lorsqu'une info-bulle de données représente un tableau, une structure ou un objet, vous pouvez développer la vue de l'info-bulle de données pour voir les membres. La vue développée affiche les informations supplémentaires sous la forme d'un arbre hiérarchique.
Pour développer la vue d'un objet dans une info-bulle de données, procédez comme suit :
Dans une info-bulle de données pour un tableau, une structure ou un objet, sélectionnez la flèche de développement devant le nom de l'élément pour afficher les membres. La vue est présentée sous forme d'arbre :
Pour une info-bulle de données épinglée, sélectionnez le symbole plus (+) devant le nom de la variable pour développer la définition.
Continuez à sélectionner les flèches de développement pour afficher d'autres éléments de la hiérarchie des membres :
Pour vous déplacer vers le haut et vers le bas dans la vue développée, utilisez la souris ou les touches fléchées Haut et Bas du clavier.
Pour épingler un membre développé avec l'info-bulle originale des données épinglées, utilisez la punaise sur le membre pour sélectionner Épingler à la source. Lorsque vous réduisez l'arborescence, tous les éléments épinglés restent visibles avec l'info-bulle des données épinglées.
Modifier les valeurs des variables
Un autre avantage de l'utilisation des info-bulles est la possibilité de modifier la valeur d'une variable ou d'un élément dans une info-bulle de données pendant le débogage. Cette fonctionnalité est utile pour tester rapidement les petites modifications apportées à votre code.
Pour modifier la valeur d'une variable ou d'un élément dans une info-bulle de données, procédez comme suit :
Dans l'info-bulle des données, sélectionnez la valeur. Visual Studio met la valeur en surbrillance et la rend disponible pour la modification.
Saisissez une nouvelle valeur dans l'info-bulle des données, puis sélectionnez Entrée.
N'oubliez pas que certaines valeurs de variables sont en lecture seule. Visual Studio ne permet pas de modifier les valeurs en lecture seule.
Utiliser des commentaires dans les info-bulles de données
La région Commentaires d'une info-bulle de données est utile pour prendre des notes sur les variables lorsque vous déboguez votre code. Cette région est un endroit pratique pour suivre les différentes valeurs lorsqu'elles changent pendant le débogage. Vous pouvez ajouter des commentaires dans une info-bulle de données épinglée ou flottante.
Pour utiliser les commentaires dans une info-bulle de données, procédez comme suit :
Dans l'info-bulle des données, utilisez la double flèche Bas pour sélectionner Développer pour voir le commentaire. La double flèche vers le bas ouvre la zone Commentaires de l'info-bulle des données, dans laquelle vous pouvez ajouter des notes.
Pour ajouter un commentaire, insérez votre curseur dans la zone Commentaires et saisissez du texte. La zone accepte plusieurs lignes.
Pour fermer la zone des commentaires, utilisez la double flèche vers le haut pour Réduire les commentaires. Les commentaires que vous avez saisis restent dans l'info-bulle des données, mais ils ne sont pas visibles pour le moment.
Épingler des propriétés dans des info-bulles de données
Visual Studio prend en charge l'épinglage de propriétés dans les info-bulles de données dans .NET Core 3.0 et les versions ultérieures. Cette fonctionnalité vous permet d'inspecter rapidement les objets en fonction de leurs propriétés dans les info-bulles de données.
Pour épingler des propriétés dans les info-bulles de données, procédez comme suit :
Dans une info-bulle de données épinglée, développez la hiérarchie des membres jusqu'à ce que vous voyiez une propriété que vous voulez garder visible avec l'info-bulle de données.
Utilisez la punaise de la propriété pour l'épingler à l'info-bulle des données. Vous pouvez également cliquer avec le bouton droit de la souris sur la propriété et sélectionner Épingler le membre comme favori.
Visual Studio déplace la propriété sélectionnée en haut de la liste des propriétés de l'objet. Le nom et la valeur de la propriété s'affichent dans la colonne de droite de l'info-bulle des données épinglées :
Pour désépingler une propriété dans une info-bulle de données, sélectionnez à nouveau l'épingle de la propriété ou cliquez avec le bouton droit de la souris sur la propriété et sélectionnez Désépingler le membre en tant que favori.
Vous pouvez également activer la visibilité des noms de propriété et filtrer les propriétés non épinglées dans la liste des propriétés de l'objet dans une info-bulle de données :
Pour filtrer les propriétés non désépinglées, cliquez avec le bouton droit de la souris sur la rangée de propriétés dans l'info-bulle de données, puis sélectionnez Afficher uniquement les membres épinglés.
Pour masquer les noms des propriétés, cliquez avec le bouton droit de la souris sur la rangée de propriétés dans l'info-bulle des données et sélectionnez Masquer les noms des membres épinglés dans les valeurs.
L'image suivante montre les différentes options du menu du clic droit pour la hiérarchie des membres dans une info-bulle de données :
Obtenir l’assistance IA
Si vous disposez de Copilot, vous pouvez bénéficier de l'assistance de l'IA pendant que vous examinez les variables dans les conseils de données. Cliquez avec le bouton droit de la souris sur une variable et utilisez le bouton Ask Copilot.
Dans ce scénario, Copilot connaît déjà le contexte de votre question, vous n'avez donc pas besoin de fournir le contexte vous-même dans le chat. Pour plus d’informations, consultez Déboguer avec Copilot.
Visualiser les types de données complexes
Les visualiseurs affichent les informations de manière plus significative et parfois graphique. Parmi les exemples de visualiseurs, citons XML, HTML, JSON et le visualiseur de texte. Vous pouvez utiliser les visualisations pour examiner des types de données complexes dans votre code pendant le débogage.
Si des visualiseurs sont disponibles pour un élément, Visual Studio affiche la loupe Afficher en regard du nom de l'élément dans l'info-bulle des données. Lorsque vous sélectionnez une visualisation, Visual Studio ouvre une fenêtre distincte pour afficher les données complexes dans un format lisible.
Vous pouvez utiliser cette fonctionnalité pour sélectionner une visualisation pour vos données :
Pour visualiser l'élément à l'aide du visualiseur par défaut pour le type de données, sélectionnez la loupe.
Pour sélectionner un visualiseur spécifique, développez la liste déroulante Afficher à côté de la loupe et choisissez une option.
Ajouter des variables aux fenêtres de surveillance
Vous pouvez continuer à surveiller les variables en les ajoutant à une fenêtre Surveiller de Visual Studio à partir d'une info-bulle de données :
- Dans l'info-bulle des données, cliquez avec le bouton droit de la souris sur le nom de la variable et sélectionnez Ajouter une surveillance.
Visual Studio ajoute la variable à la fenêtre de surveillance. Si votre édition de Visual Studio prend en charge plusieurs fenêtres surveillance, la variable apparaît dans la fenêtre intitulée Watch 1.
Importation et exportation de datatips
Vous pouvez exporter des info-bulles de données vers un fichier XML, que vous pouvez partager ou modifier à l'aide d'un éditeur de texte. Vous pouvez également importer une info-bulle de données à partir d'un fichier XML que vous avez reçu ou que vous avez précédemment modifié.
Pour exporter des info-bulles de données, procédez comme suit :
Dans Visual Studio, sélectionnez Débogage>Exporter les info-bulles de données. La boîte de dialogue Exporter les info-bulles de données s'ouvre.
Dans la boîte de dialogue, parcourez l'emplacement où vous souhaitez enregistrer le fichier XML.
Saisissez un nom pour le fichier d'exportation et sélectionnez Enregistrer.
Visual Studio exporte vos info-bulles de données vers le fichier et l'emplacement spécifiés.
Pour importer des info-bulles de données à partir d'un fichier, procédez comme suit :
Dans Visual Studio, sélectionnez Débogage>Importer les info-bulles de données. La boîte de dialogue Importer des infobulles de données s'ouvre.
Dans la boîte de dialogue, parcourez l'emplacement du fichier XML d'info-bulles de données à utiliser pour l'importation.
Sélectionnez le fichier à ouvrir, puis cliquez sur Ouvrir.
Visual Studio importe les info-bulles de données du fichier spécifié dans votre espace de travail actuel. Lorsque vous déboguez le code de l'espace de travail, les info-bulles de données importées sont disponibles.