Trace Classe

Définition

public ref class Trace sealed

public sealed class Trace

type Trace = class

Public NotInheritable Class Trace

Héritage

Object

Trace

Exemples

L’exemple suivant utilise Trace pour indiquer le début et la fin de l’exécution d’un programme. L’exemple utilise également les méthodes et Trace.Unindent les Trace.Indent méthodes pour distinguer la sortie de suivi. Pour obtenir un exemple plus complet de l’utilisation de , consultez Guide pratique pour ajouter des instructions deTrace trace au code d’application.

// Specify /d:TRACE when compiling.

using System;
using System.Diagnostics;

class Test
{
    static void Main()
    {
       Trace.Listeners.Add(new TextWriterTraceListener(Console.Out));
       Trace.AutoFlush = true;
       Trace.Indent();
       Trace.WriteLine("Entering Main");
       Console.WriteLine("Hello World.");
       Trace.WriteLine("Exiting Main");
       Trace.Unindent();
    }
}

' Specify /d:TRACE=True when compiling.

Imports System.Diagnostics

Class Test
    
    Shared Sub Main()
    
        Trace.Listeners.Add(New TextWriterTraceListener(Console.Out))
        Trace.AutoFlush = True
        Trace.Indent()
        Trace.WriteLine("Entering Main")
        Console.WriteLine("Hello World.")
        Trace.WriteLine("Exiting Main")
        Trace.Unindent()
        
    End Sub

End Class

Remarques

Vous pouvez utiliser les propriétés et méthodes de la Trace classe pour instrumenter les builds de mise en production. L’instrumentation vous permet de surveiller l’intégrité de votre application s’exécutant dans des paramètres réels. Le suivi vous aide à isoler les problèmes et à les résoudre sans déranger un système en cours d’exécution.

Cette classe fournit des méthodes pour afficher une Assert boîte de dialogue et émettre une assertion qui sera toujours Fail. Cette classe fournit des méthodes d’écriture dans les variantes suivantes :

• Write
• WriteLine
• WriteIf
• WriteLineIf

Les BooleanSwitch classes et TraceSwitch les classes fournissent des moyens de contrôler dynamiquement la sortie de suivi. Dans .NET applications Framework, vous pouvez modifier les valeurs de ces commutateurs sans recompiler votre application. Pour plus d’informations sur l’utilisation du fichier de configuration pour définir un commutateur dans une application .NET Framework, consultez la classe Switch et How to : Create, Initialize et Configure Trace Switch.

Vous pouvez personnaliser la cible de la sortie de suivi en ajoutant TraceListener ou en supprimant des instances de la Listeners collection. La Listeners collection est partagée à la fois par les classes et par l’ajout DebugTrace d’un écouteur de trace à l’une ou l’autre classe ajoute l’écouteur aux deux. Par défaut, la sortie de trace est émise à l’aide de la DefaultTraceListener classe.

La Trace classe fournit des propriétés pour obtenir ou définir le niveau et Indent le IndentSizeniveau , et s’il faut AutoFlush le faire après chaque écriture.

Dans les applications .NET Framework, vous pouvez définir les AutoFlush et IndentSize pour Trace en modifiant le fichier de configuration correspondant au nom de votre application. Le fichier de configuration doit être mis en forme comme dans l’exemple suivant :

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="3" />
  </system.diagnostics>
</configuration>

L’attribut ConditionalAttribute est appliqué aux méthodes de Trace. Les compilateurs qui prennent en charge ConditionalAttribute l’ignorer les appels à ces méthodes, sauf s’ils TRACE sont définis comme symbole de compilation conditionnelle. Reportez-vous à la documentation d’un compilateur pour déterminer si ConditionalAttribute elle est prise en charge et la syntaxe permettant de définir un symbole de compilation conditionnelle.

Pour définir le TRACE symbole de compilation conditionnelle en C#, ajoutez l’option /d:TRACE à la ligne de commande du compilateur lorsque vous compilez votre code à l’aide d’une ligne de commande ou ajoutez-y #define TRACE en haut de votre fichier. Dans Visual Basic, ajoutez l’option /d:TRACE=True à la ligne de commande du compilateur ou ajoutez-y #Const TRACE=True .

ConditionalAttribute n’est pas pris en charge par le compilateur C++. Pour fournir des fonctionnalités équivalentes, vous devez placer des appels aux méthodes d’un Trace#if defined(TRACE) ... #endif bloc et ajouter l’option /DTRACE à la ligne de commande du compilateur ou ajouter #define TRACE au fichier.

Cohérence de thread

Ce type est thread safe.

Voir aussi

• Debug
• Switch
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• EventLogTraceListener
• TraceListenerCollection
• ConditionalAttribute