Informations de journal dans la fenêtre Sortie à l’aide de points de trace dans Visual Studio

L’exemple de programme suivant est une boucle simple for avec une variable de compteur qui augmente d’une fois que la boucle exécute une autre itération.

using System.Diagnostics;

namespace Tracepoints
{
    public class Program
    {
        public static void Main(string[] args)
        {
            int counter = 0;
            for (int i=0; i<=10; i++)
            {
                counter +=1;
            }
        }
    }
}

Vous pouvez définir des points de trace en spécifiant une chaîne de sortie sous la case Action dans la fenêtre Paramètres du point d’arrêt.

1. Pour initialiser un point de trace, cliquez d’abord sur la coupe à gauche du numéro de ligne où vous souhaitez définir le point de trace.

   

2. Pointez sur le cercle rouge et cliquez sur l’icône d’engrenage pour ouvrir la fenêtre Paramètres du point d’arrêt.

   

3. Cochez la case Action .

   

   Notez comment le cercle rouge passe à un diamant indiquant que vous avez basculé d’un point d’arrêt vers un point de trace.

4. Entrez le message que vous souhaitez vous connecter à la zone de texte Afficher un message dans la fenêtre de sortie (pour plus d’informations, consultez les sections ultérieures de cet article).

   Votre point de trace est maintenant défini. Appuyez sur le bouton « Fermer » si vous souhaitez enregistrer certaines informations dans la fenêtre sortie.

5. Si vous souhaitez ajouter des conditions qui déterminent si votre message s’affiche, cochez la case Conditions .

   

   Vous avez trois choix pour les conditions : Expression conditionnelle, Filtre et Nombre d’accès.

Ce menu vous permet de consigner un message dans la fenêtre Sortie. Tapez les chaînes que vous souhaitez générer dans la zone de message (pas de guillemets nécessaires). Si vous souhaitez afficher des valeurs de variables, veillez à l’inclure dans des accolades.

Par exemple, si vous souhaitez afficher la valeur de la counter variable dans la console de sortie, tapez {counter} la zone de texte du message.

Si vous cliquez sur Fermer , puis déboguez le programme (F5), vous voyez la sortie suivante dans la fenêtre Sortie.

Vous pouvez également utiliser des mots clés spéciaux pour afficher des informations plus spécifiques. Entrez le mot clé exactement comme indiqué ci-dessous (utilisez un « $ » devant chaque mot clé et toutes les majuscules pour le mot clé lui-même).

Pour une expression conditionnelle, un message de sortie s’affiche uniquement lorsque certaines conditions sont remplies.

Pour les expressions conditionnelles, vous pouvez définir le point de trace pour générer un message lorsqu’une certaine condition est vraie ou lorsqu’elle a changé. Par exemple, si vous souhaitez uniquement afficher la valeur du compteur pendant les itérations de la for boucle, vous pouvez sélectionner l’option Is true , puis taper i%2 == 0 dans la zone de texte du message.

Si vous souhaitez imprimer la valeur du compteur lorsque l’itération de la for boucle change, sélectionnez l’option When changed et tapez i la zone de texte du message.

Le comportement de l’option When changed est différent pour différents langages de programmation.

• Pour le code natif, le débogueur ne considère pas la première évaluation de la condition comme une modification. Par conséquent, il n’atteint pas le point de trace lors de la première évaluation.
• Pour le code managé, le débogueur atteint le point de trace lors de la première évaluation après la sélection de la modification .

Vous pouvez également définir la condition lorsque le point de trace peut être activé en insérant un point d’arrêt dans une section particulière du code et en cochant la case Activer uniquement lorsque le point d’arrêt suivant est activé : option dans le menu Paramètres du point d’arrêt. Vous pouvez choisir n’importe quel point d’arrêt dans la liste des choix.

Pour un examen plus complet des expressions valides que vous pouvez utiliser lors de la définition de conditions, consultez Expressions dans le débogueur.

Obtenir de l’aide sur l’IA

Si vous avez Copilot, vous pouvez obtenir de l’aide sur l’IA pendant la création d’un point de trace. Copilot vous propose des suggestions pour les points d’arrêt conditionnels et les points de trace spécifiques à votre code.

Pour plus d’informations, consultez Déboguer avec Copilot.

Une condition de nombre d’accès vous permet d’envoyer la sortie uniquement après la ligne de code où le point de trace est défini a exécuté un nombre spécifié de fois.

Pour le nombre d’accès, vous pouvez choisir de générer un message lorsque la ligne de code où le point de trace est défini a été exécutée un nombre particulier de fois. Selon l’exigence, il peut être égal à, ou est un multiple, ou est supérieur ou égal à la valeur de nombre d’accès spécifiée. Choisissez l’option qui convient le mieux à vos besoins et tapez une valeur entière dans le champ (par exemple, 5) qui représente cette itération d’intérêt.

Vous pouvez également supprimer le point d’arrêt sur le premier accès en activant la case à cocher Supprimer le point d’arrêt une fois atteint.

Pour une condition de filtre, spécifiez les appareils, les processus ou les threads pour lesquels la sortie est affichée.

Liste des expressions de filtre :

• MachineName = « name »
• ProcessId = valeur
• ProcessName = « name »
• ThreadId = valeur
• ThreadName = « name »

Placez des chaînes (telles que des noms) entre guillemets doubles. Les valeurs peuvent être entrées sans guillemets. Vous pouvez combiner des clauses à l’aide & de (AND), || (), OR (!NOT) et de parenthèses.