Afficher les valeurs des données dans les datatips de l'éditeur de code

  • Article

Les datatips sont un moyen pratique de visualiser des informations sur les variables de votre programme au cours du débogage. Les datatips ne fonctionnent qu'en mode arrêt, et uniquement avec les variables comprises dans la portée d'exécution actuelle. Si c’est la première fois que vous essayez de déboguer du code, vous pouvez consulter Débogage pour grands débutants et Techniques et outils de débogage avant de poursuivre cet article.

Utiliser les datatips

Les datatips ne s’affichent qu'en mode arrêt, et uniquement sur les variables comprises dans la portée d'exécution actuelle.

Afficher un datatip

  1. Définissez un point d’arrêt dans votre code et démarrez le débogage en appuyant sur F5 ou en sélectionnant Démarrer>le débogage.

  2. Lorsque l’exécution est suspendue au niveau du point d’arrêt, pointez sur n’importe quelle variable dans l’étendue actuelle. Une datatip s’affiche, affichant le nom et la valeur actuelle de la variable.

Rendre un datatip transparent

Pour rendre un datatip transparent et afficher le code qui se trouve en dessous, dans le datatip, appuyez sur Ctrl. Le datatip reste transparent tant que vous maintenez la touche Ctrl enfoncée. Cela ne fonctionne pas pour les datatips épinglés ou flottants.

Conserver un datatip développé

À compter de Visual Studio 2022 Update 1, lorsque vous développez un datatip, vous pouvez le conserver développé jusqu’à ce que vous cliquiez ailleurs. C’est ce qu’on appelle un datatip collant. Pour activer cette fonctionnalité, sélectionnezOutils>Options>Débogage, puis, sous l’onglet Général, sélectionnez Maintenir les datatips ouverts jusqu’à ce que vous cliquiez ailleurs.

Épingler un datatip

Pour épingler un datatip afin qu’il reste ouvert, sélectionnez la punaise Épingler à la source .

Pin a data tip

Vous pouvez déplacer un datatip épinglé en le faisant glisser dans la fenêtre de code. Une icône de punaise apparaît dans la marge à côté de la ligne à laquelle le datatip est épinglé.

Notes

Les conseils relatifs aux données sont toujours évalués dans le contexte où l'exécution est interrompue, et non pas le l’emplacement actuel du curseur ou du datatip. Si vous pointez sur une variable dans une autre fonction portant le même nom qu'une variable qui est dans le contexte actuel, la valeur de la variable dans le contexte actuel s’affiche.

Désépingler un datatip de la source

Pour faire flotter un datatip épinglé, pointez sur le datatip et sélectionnez l’icône de punaise dans le menu contextuel.

L’icône de punaise passe à la position non désépinglée, et maintenant le datatip flotte ou peut être déplacé au-dessus de toutes les fenêtres ouvertes. Les datatips flottants se ferment à la fin de la session de débogage.

Ré-épingler un datatip

Pour épingler à nouveau un datatip flottant à la source, pointez sur celui-ci dans l’éditeur de code et sélectionnez l’icône de punaise. L’icône de punaise passe à la position épinglée, et le datatip est à nouveau épinglé uniquement à la fenêtre de code.

Si un datatip flotte au-dessus d’une fenêtre de code non source, l’icône de punaise n’est pas disponible et le datatip ne peut pas être ré-épinglé. Pour accéder à l’icône punaise, retournez le datip dans la fenêtre de l’éditeur de code en le faisant glisser ou en mettant le focus sur la fenêtre de code.

Fermer un datatip

Pour fermer un datatip, pointez sur le datatip et sélectionnez l’icône fermer (x) dans le menu contextuel.

Fermer tous les datatips

Pour fermer tous les datatips, dans le menu Déboguer, sélectionnez Effacer tous les datatips.

Pour fermer tous les datatips d'un fichier spécifique

Pour fermer tous les datatips pour un fichier spécifique, dans le menu Déboguer, sélectionnez Effacer tous les conseils de données épinglés au <Nom de fichier>.

Développer et modifier des informations

Vous pouvez utiliser les datatips pour développer un tableau, une structure ou un objet afin d’en afficher les membres. Vous pouvez également modifier la valeur d'une variable depuis un datatip.

Développer une variable

Pour développer un objet dans un datatip, afin d’afficher ses éléments, pointez sur les flèches de développement avant les noms des éléments pour afficher les éléments sous forme d’arborescence. Pour un datatip épinglé, sélectionnez le + avant le nom de la variable, puis développez l’arborescence.

Expand a data tip

Vous pouvez utiliser la souris ou les touches de direction du clavier pour monter et descendre dans la vue développée.

Vous pouvez également épingler des éléments développés au conseil de données épinglé en pointant sur eux et en sélectionnant leurs icônes de punaise. Les éléments apparaissent ensuite dans le datatip épinglé une fois l’arborescence réduite.

Modifier la valeur d'une variable

Pour modifier la valeur d’une variable ou d’un élément dans un datatip, sélectionnez la valeur, tapez une nouvelle valeur, puis appuyez sur Entrée. La sélection est désactivée pour les valeurs en lecture seule.

Épingler les propriétés dans les datatips

Remarque

Cette fonctionnalité est prise en charge pour .NET Core 3.0 ou pour une version ultérieure.

Vous pouvez rapidement inspecter les objets en fonction de leurs propriétés dans les datatips avec l’outil Propriétés épinglées. Pour utiliser cet outil, passez le curseur sur une propriété et sélectionnez l’icône d’épingle qui s’affiche ou faites un clic droit, puis sélectionnez l’option Épingler le membre comme favori dans le menu contextuel résultant. Cette propriété s’affiche en haut de la liste des propriétés de l’objet, et le nom et la valeur de la propriété s’affichent dans la colonne de droite du datatip. Pour désépingler une propriété, sélectionnez à nouveau l’icône d’épingle ou sélectionnez l’option Désépingler le membre en tant que favori dans le menu contextuel.

Pinning a property in a data tip

Vous pouvez également désactiver les noms de propriétés et filtrer les propriétés non épinglées lors de l’affichage de la liste des propriétés de l’objet dans un datatip. Vous pouvez accéder à l’une ou l’autre option en cliquant avec le bouton droit sur une ligne contenant une propriété et en sélectionnant les options Afficher uniquement les membres épinglés ou Masquer les noms de membres épinglés dans les valeurs dans le menu contextuel.

Visualiser les types de données complexes

Une icône de loupe en regard d’une variable ou d’un élément dans un datatip signifie qu’un ou plusieurs visualiseurs, tels que le visualiseur de texte, sont disponibles pour la variable. Les visualiseurs affichent les informations d’une manière plus explicite, parfois graphique.

Pour afficher l’élément à l’aide du visualiseur par défaut pour le type de données, sélectionnez l’icône de loupe Visualizer icon. Sélectionnez la flèche en regard de l’icône de loupe pour sélectionner dans une liste de visualiseurs pour le type de données.

Ajouter une variable à la fenêtre Espion

Si vous voulez continuer à surveiller une variable, vous pouvez l'ajouter à la fenêtre Espion à partir d'un datatip. Cliquez avec le bouton droit sur la variable dans le datatip, puis sélectionnez Ajouter espion.

La variable s’affiche dans la fenêtre Espion. Si votre édition Visual Studio prend en charge plusieurs fenêtre Espion, la variable s’affiche dans Espion 1.

Importation et exportation de datatips

Vous pouvez exporter des datatips vers un fichier XML, que vous pouvez partager ou modifier à l’aide d’un éditeur de texte. Vous pouvez également importer un fichier XML de datatip que vous avez reçu ou modifié.

Pour exporter des datatips :

  1. Sélectionnez Déboguer>Exporter les datatips.

  2. Dans la boîte de dialogue Exporter les datatips, accédez à l’emplacement pour enregistrer le fichier XML, tapez un nom pour le fichier, puis sélectionnez Enregistrer.

Pour importer des datatips :

  1. Sélectionnez Déboguer>Importer des datatips.

  2. Dans la boîte de dialogue Importer des datatips, sélectionnez le fichier XML de datatips que vous souhaitez ouvrir, puis sélectionnez Ouvrir.

Contenu connexe