Afficher les valeurs de données dans DataTips dans l’éditeur de code

S’applique à :yes Visual Studio Visual Studio nopour Mac noVisual Studio Coder

Les conseils de données fournissent un moyen pratique d’afficher des informations sur les variables de votre programme pendant le débogage. Les conseils de données fonctionnent uniquement en mode arrêt et uniquement avec les variables qui se trouvent dans l’étendue actuelle de l’exécution. Si c’est la première fois que vous avez essayé de déboguer du code, vous pouvez lire le débogage pour les débutants absolus et lestechniques et outils de débogage avant de passer à cet article.

Utiliser des conseils sur les données

Les conseils de données apparaissent uniquement en mode arrêt et uniquement sur les variables qui se trouvent dans l’étendue actuelle de l’exécution.

Afficher un conseil de données

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

  2. En cas de pause au point d’arrêt, pointez sur n’importe quelle variable dans l’étendue actuelle. Un conseil de données s’affiche, affichant le nom et la valeur actuelle de la variable.

Rendre un conseil de données transparent

Pour rendre un conseil de données transparent pour voir le code sous celui-ci, alors que dans le conseil de données, appuyez sur Ctrl. Le conseil de données reste transparent tant que vous maintenez la touche Ctrl enfoncée. Cela ne fonctionne pas pour les conseils de données épinglés ou flottants.

Conserver un conseil de données développé

À compter de Visual Studio 2022 Update 1, lorsque vous développez un conseil de données, vous pouvez le conserver jusqu’à ce que vous cliquez ailleurs. Il s’agit d’un conseil de données collant. Pour activer cette fonctionnalité, sélectionnezDébogagedes optionsd’outils>>, puis, sous l’onglet Général, sélectionnez Conserver les conseils de données développés ouverts jusqu’à ce que vous ne cliquez plus.

Épingler un conseil de données

Pour épingler un conseil de données afin qu’il reste ouvert, sélectionnez l’icône Épingler à la source .

Pin a data tip

Vous pouvez déplacer un conseil de données épinglé en le faisant glisser autour de la fenêtre de code. Une icône pushpin s’affiche en regard de la ligne vers laquelle le conseil de données est épinglé.

Notes

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

Désinpiner un conseil de données à partir de la source

Pour flotter un conseil de données épinglé, pointez sur le conseil de données et sélectionnez l’icône pushpin dans le menu contextuel.

L’icône pushpin change à la position non épinglée, et le conseil de données flotte maintenant ou peut être déplacé au-dessus de toutes les fenêtres ouvertes. Les conseils de données flottants se ferment lorsque la session de débogage se termine.

Épingler une info-bulle de données

Pour épingler une info-bulle de données flottante à la source, pointez dessus dans l’éditeur de code et sélectionnez l’icône pushpin. L’icône pushpin change de position épinglée et le conseil de données est à nouveau épinglé uniquement dans la fenêtre de code.

Si un conseil de données flotte sur une fenêtre de code non source, l’icône pushpin n’est pas disponible et le conseil de données ne peut pas être repiné. Pour accéder à l’icône pushpin, retournez le conseil de données à la fenêtre de l’éditeur de code en le faisant glisser ou en lui donnant le focus de la fenêtre de code.

Fermer un conseil de données

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

Fermer tous les conseils de données

Pour fermer tous les conseils de données, dans le menu Déboguer , sélectionnez Effacer tous les conseils de données.

Fermer tous les conseils de données pour un fichier spécifique

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

Développer et modifier des informations

Vous pouvez utiliser des conseils de données pour développer un tableau, une structure ou un objet pour afficher ses membres. Vous pouvez également modifier la valeur d’une variable à partir d’un conseil de données.

Développer une variable

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

Expand a data tip

Vous pouvez utiliser la souris ou les touches de direction sur le 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 dessus et en sélectionnant leurs icônes pushpin. Les éléments apparaissent ensuite dans le conseil de données é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 conseil de données, 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 conseils de données

Notes

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

Vous pouvez rapidement inspecter les objets par leurs propriétés dans les conseils de données avec l’outil Propriétés pinnables . Pour utiliser cet outil, pointez sur une propriété et sélectionnez l’icône d’épingle qui s’affiche ou cliquez avec le bouton droit et sélectionnez l’option Épingler le membre comme favori dans le menu contextuel résultant. Cela bulle cette propriété 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 droite du conseil de données. Pour annuler une propriété, sélectionnez à nouveau l’icône d’épingle ou sélectionnez l’option Annuler le membre en tant que favori dans le menu contextuel.

! [Épinglage d’une propriété dans un conseil de données] (.. /debugger/media/basic-pin-data tip.gif « Épinglage d’une propriété dans un conseil de données »)

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 conseil de données. 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 membres épinglés uniquement ou masquer les noms de membres épinglés dans les options de valeurs dans le menu contextuel.

Visualiser des types de données complexes

Une icône de loupe en regard d’une variable ou d’un élément dans un conseil de données signifie qu’un ou plusieurs visualiseurs, tels que le visualiseur de texte, sont disponibles pour la variable. Les visualiseurs affichent des informations de 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 Visualizer iconde loupe. 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 à une fenêtre Espion

Si vous souhaitez continuer à regarder une variable, vous pouvez l’ajouter à une fenêtre Espion à partir d’un conseil de données. Cliquez avec le bouton droit sur la variable dans le conseil de données, puis sélectionnez Ajouter une montre.

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

Conseils sur l’importation et l’exportation des données

Vous pouvez exporter des conseils de données 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 conseil de données que vous avez reçu ou modifié.

Pour exporter des conseils sur les données :

  1. SélectionnezExporter des info-bulles d’exportation de débogage>.

  2. Dans la boîte de dialogue Exporter des info-bulles de données , accédez à l’emplacement pour enregistrer le fichier XML, tapez un nom pour le fichier, puis sélectionnez Enregistrer.

Pour importer des conseils sur les données :

  1. SélectionnezImporter des info-bulles de débogage>.

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

Voir aussi