Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ConsoleTraceListener classe

 

Date de publication : novembre 2016

Dirige le traçage ou le débogage de la sortie vers la sortie standard ou le flux d’erreur standard.

Espace de noms:   System.Diagnostics
Assembly:  System (dans System.dll)

System.Object
  System.MarshalByRefObject
    System.Diagnostics.TraceListener
      System.Diagnostics.TextWriterTraceListener
        System.Diagnostics.ConsoleTraceListener

[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)]
public class ConsoleTraceListener : TextWriterTraceListener

NomDescription
System_CAPS_pubmethodConsoleTraceListener()

Initialise une nouvelle instance de la ConsoleTraceListener classe avec la sortie de trace écrite dans le flux de sortie standard.

System_CAPS_pubmethodConsoleTraceListener(Boolean)

Initialise une nouvelle instance de la ConsoleTraceListener classe avec une option pour écrire la sortie de trace dans le flux de sortie standard ou le flux d’erreur standard.

NomDescription
System_CAPS_pubpropertyAttributes

Obtient les attributs d'écouteur de trace personnalisés définis dans le fichier de configuration de l'application.(Hérité de TraceListener.)

System_CAPS_pubpropertyFilter

Obtient et définit le filtre de trace pour l'écouteur de trace.(Hérité de TraceListener.)

System_CAPS_pubpropertyIndentLevel

Obtient ou définit le niveau de retrait.(Hérité de TraceListener.)

System_CAPS_pubpropertyIndentSize

Obtient ou définit le nombre d'espaces dans un retrait.(Hérité de TraceListener.)

System_CAPS_pubpropertyIsThreadSafe

Obtient une valeur qui indique si l'écouteur de trace est thread-safe.(Hérité de TraceListener.)

System_CAPS_pubpropertyName

Obtient ou définit un nom pour ce TraceListener.(Hérité de TraceListener.)

System_CAPS_protpropertyNeedIndent

Obtient ou définit une valeur indiquant si la sortie doit être mise en retrait.(Hérité de TraceListener.)

System_CAPS_pubpropertyTraceOutputOptions

Obtient ou définit les options de sortie de trace.(Hérité de TraceListener.)

System_CAPS_pubpropertyWriter

Obtient ou définit le writer de texte qui reçoit le suivi ou la sortie de débogage.(Hérité de TextWriterTraceListener.)

NomDescription
System_CAPS_pubmethodClose()

Ferme la sortie au flux spécifié pour cet écouteur de suivi.(Remplace TextWriterTraceListener.Close().)

System_CAPS_pubmethodCreateObjRef(Type)

Crée un objet qui contient toutes les informations requises pour générer un proxy permettant de communiquer avec un objet distant.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodDispose()

Libère toutes les ressources utilisées par TraceListener.(Hérité de TraceListener.)

System_CAPS_protmethodDispose(Boolean)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Supprime cette TextWriterTraceListener objet.(Hérité de TextWriterTraceListener.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodFail(String)

Émet un message d'erreur à l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.(Hérité de TraceListener.)

System_CAPS_pubmethodFail(String, String)

Émet un message d'erreur, ainsi qu'un message d'erreur détaillé, à l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.(Hérité de TraceListener.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodFlush()

Vide la mémoire tampon de sortie pour le Writer.(Hérité de TextWriterTraceListener.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetLifetimeService()

Récupère l’objet de service de durée de vie actuelle qui contrôle la stratégie de durée de vie de cette instance.(Hérité de MarshalByRefObject.)

System_CAPS_protmethodGetSupportedAttributes()

Obtient les attributs personnalisés pris en charge par l'écouteur de trace.(Hérité de TraceListener.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodInitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.(Hérité de MarshalByRefObject.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Crée une copie superficielle d’actuel MarshalByRefObject objet.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodTraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Écrit les informations sur la trace, un objet de données et les informations sur les événements dans la sortie spécifique de l'écouteur.(Hérité de TraceListener.)

System_CAPS_pubmethodTraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Écrit les informations sur la trace, un tableau d'objets de données et les informations sur les événements dans la sortie spécifique de l'écouteur.(Hérité de TraceListener.)

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32)

Écrit les informations sur la trace et les événements dans la sortie spécifique de l'écouteur.(Hérité de TraceListener.)

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Écrit les informations sur la trace, un message et les informations sur les événements dans la sortie spécifique de l'écouteur.(Hérité de TraceListener.)

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Écrit les informations sur la trace, un tableau d'objets mis en forme et les informations sur les événements dans la sortie spécifique de l'écouteur.(Hérité de TraceListener.)

System_CAPS_pubmethodTraceTransfer(TraceEventCache, String, Int32, String, Guid)

Écrit les informations sur la trace, un message, une identité d'activité connexe et les informations sur les événements dans la sortie spécifique de l'écouteur.(Hérité de TraceListener.)

System_CAPS_pubmethodWrite(Object)

Écrit la valeur de la méthode ToString de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.(Hérité de TraceListener.)

System_CAPS_pubmethodWrite(Object, String)

Écrit un nom de catégorie ou la valeur de la méthode ToString de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.(Hérité de TraceListener.)

System_CAPS_pubmethodWrite(String)

Écrit un message de cette instance Writer.(Hérité de TextWriterTraceListener.)

System_CAPS_pubmethodWrite(String, String)

Écrit un nom de catégorie et un message dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.(Hérité de TraceListener.)

System_CAPS_protmethodWriteIndent()

Écrit la mise en retrait dans l'écouteur que vous créez lors de l'implémentation de cette classe et rétablit la valeur false à la propriété NeedIndent.(Hérité de TraceListener.)

System_CAPS_pubmethodWriteLine(Object)

Écrit la valeur de la méthode ToString de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener, suivie d'une marque de fin de ligne.(Hérité de TraceListener.)

System_CAPS_pubmethodWriteLine(Object, String)

Écrit un nom de catégorie ou la valeur de la méthode ToString de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener, suivis d'une marque de fin de ligne.(Hérité de TraceListener.)

System_CAPS_pubmethodWriteLine(String)

Écrit un message de cette instance Writer suivie d’un terminateur de ligne. Le terminateur de ligne par défaut est un retour chariot suivi d’un saut de ligne (\r\n).(Hérité de TextWriterTraceListener.)

System_CAPS_pubmethodWriteLine(String, String)

Écrit un nom de catégorie ou un message dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener, suivis d'une marque de fin de ligne.(Hérité de TraceListener.)

Utilisez la ConsoleTraceListener classe écrire trace et débogage des messages sur la console. Vous pouvez initialiser un ConsoleTraceListener objet à écrire des messages de suivi pour le Console.Out flux ou à la Console.Error flux.

System_CAPS_importantImportant

IDisposable interface. Lorsque vous avez fini d'utiliser le type, vous devez supprimer de celui-ci, directement ou indirectement. Pour supprimer le type directement, appelez sa Dispose méthode dans untry/catch bloc. Pour la supprimer indirectement, utiliser une construction de langage telles que using (en c#) ou Using (en Visual Basic). Pour plus d'informations, consultez la section « Utilisant un objet qui implémente IDisposable » dans la IDisposable rubrique de l'interface.

Lorsque le suivi et la sortie de débogage est activé, le ConsoleTraceListener les messages sont écrits spécifié System.Console flux, qui est similaire à la façon dont les messages sont écrits avec le Console.Write ou Console.WriteLine méthodes. Dans une application console, les System.Console flux de sortie et d’erreur écrivent des messages dans la fenêtre de console existante, ou vous pouvez rediriger les flux pour écrire dans un System.IO.TextWriter instance.

System_CAPS_noteRemarque

Si la console n’existe pas, comme dans une application basée sur Windows, les messages écrits dans la console ne sont pas affichés.

Ajouter un ConsoleTraceListener objet approprié Listeners collection si vous souhaitez que les messages écrits via Trace, TraceSource, ou Debug à écrire dans la console. En outre, vous pouvez écrire des messages directement à la console à l’aide de la Trace.Write ou Trace.WriteLine méthodes.

System_CAPS_noteRemarque

Le Debug et Trace classes partagent le même TraceListenerCollection collection, accédée via respectives Listeners Propriétés. Si vous ajoutez un ConsoleTraceListener de l’objet à la collection à l’aide d’une de ces classes, l’autre classe utilise automatiquement le même écouteur.

La plupart des compilateurs activer trace sortie et de débogage via des indicateurs de compilation conditionnelle. Si vous n’activez pas le traçage ou le débogage, les messages écrits via les System.Diagnostics.Debug et System.Diagnostics.Trace classes sont effectivement ignorés. La syntaxe pour activer le suivi et la sortie de débogage est spécifique au compilateur ; Si vous utilisez des compilateurs autres que c# ou Visual Basic, reportez-vous à la documentation de votre compilateur.

  • Pour activer le débogage en c#, ajoutez le /d : Debugindicateur pour la ligne de commande du compilateur lorsque vous compilez votre code, ou vous pouvez ajouter #define DEBUG en haut de votre fichier. Dans Visual Basic, ajoutez le /d : DEBUG = True indicateur pour la ligne de commande du compilateur.

  • Pour activer le traçage en c#, ajoutez le r indicateur pour la ligne de commande du compilateur lorsque vous compilez votre code, ou ajoutez #define TRACE en haut de votre fichier. Dans Visual Basic, ajoutez le /d : trace = True indicateur pour la ligne de commande du compilateur.

Vous pouvez ajouter un ConsoleTraceListener de l’objet à le Listeners collection dans votre code, ou vous pouvez ajouter un ConsoleTraceListener à l’objet le Listeners collection via le fichier de configuration d’application. Ajouter le ConsoleTraceListener l’objet dans votre code pour écrire des messages pour un chemin de section ou de l’exécution de code spécifique. Ajouter la ConsoleTraceListener objet dans votre fichier de configuration d’application pour diriger tous les trace et debug des messages à la console pendant que l’application s’exécute.

Pour écrire trace et debug des messages sur la console pour une section spécifique de code, initialisez une ConsoleTraceListener de l’objet et l’ajouter à la Listeners collection. Instrumentez la section de code qui contient des messages à l’aide de la Trace ou Debug classes. À la fin de la section de code, supprimez le ConsoleTraceListener à partir de l’objet du Listeners collection et appeler la Close méthode sur le ConsoleTraceListener.

Pour diriger la trace de toutes les et déboguer des messages sur la console pendant que l’application s’exécute, ajoutez un ConsoleTraceListener l’objet dans le fichier de configuration. Modifier le fichier de configuration qui correspond au nom de votre application, ou le fichier app.config dans un Visual Studio 2005 projet. Dans ce fichier, insérez un élément pour un ConsoleTraceListener.

L’exemple suivant ajoute un ConsoleTraceListener objet nommé configConsoleListener à la Listeners collection.

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="configConsoleListener"           type="System.Diagnostics.ConsoleTraceListener" />
      </listeners>
    </trace>
  </system.diagnostics>
 </configuration>

Pour plus d’informations sur l’ajout d’écouteurs de la trace dans le fichier de configuration d’application, consultez la page <listeners>, élément de <trace>.

L’exemple de code suivant implémente une application console qui se compose d’une classe avec deux méthodes publiques.

Le Main méthode examine les arguments de ligne de commande et détermine si la sortie de suivi doit être dirigé vers le flux d’erreurs standard ou le flux de sortie standard. Main Crée et initialise un ConsoleTraceListener objet spécifié Console flux de sortie et ajoute cet objet à la collection d’écouteurs de suivi. Il appelle ensuite la WriteEnvironmentInfoToTrace (méthode), qui écrit les informations sur l’environnement d’exécution et la configuration d’écouteur de suivi à la sortie de trace.

Lorsque l’application d’exemple s’exécute, les détails de configuration d’environnement et de trace sont écrits dans le flux de sortie de console spécifié via le ConsoleTraceListener objet.

// Define the TRACE directive, which enables trace output to the 
// Trace.Listeners collection. Typically, this directive is defined
// as a compilation argument.
#define TRACE
using System;
using System.Diagnostics;

public class ConsoleTraceSample
{

    // Define a simple method to write details about the current executing 
    // environment to the trace listener collection.
    public static void WriteEnvironmentInfoToTrace()
    {

        string methodName = "WriteEnvironmentInfoToTrace";

        Trace.Indent();
        Trace.WriteLine(DateTime.Now.ToString() + " - Start of " + methodName);
        Trace.Indent();

        // Write details on the executing environment to the trace output.
        Trace.WriteLine("Operating system: " + System.Environment.OSVersion.ToString());
        Trace.WriteLine("Computer name: " + System.Environment.MachineName);
        Trace.WriteLine("User name: " + System.Environment.UserName);
        Trace.WriteLine("CLR runtime version: " + System.Environment.Version.ToString());
        Trace.WriteLine("Command line: " + System.Environment.CommandLine);

        // Enumerate the trace listener collection and 
        // display details about each configured trace listener.
        Trace.WriteLine("Number of configured trace listeners = " + Trace.Listeners.Count.ToString());

        foreach (TraceListener tl in Trace.Listeners)
        {
            Trace.WriteLine("Trace listener name = " + tl.Name);
            Trace.WriteLine("               type = " + tl.GetType().ToString());
        }

        Trace.Unindent();
        Trace.WriteLine(DateTime.Now.ToString() + " - End of " + methodName);
        Trace.Unindent();

    }

    // Define the main entry point of this class.
    // The main method adds a console trace listener to the collection
    // of configured trace listeners, then writes details on the current
    // executing environment.
    public static void Main(string[] CmdArgs)
    {

        // Write a trace message to all configured trace listeners.
        Trace.WriteLine(DateTime.Now.ToString()+" - Start of Main");

        // Define a trace listener to direct trace output from this method
        // to the console.
        ConsoleTraceListener consoleTracer;

        // Check the command line arguments to determine which
        // console stream should be used for trace output.
        if ((CmdArgs.Length>0)&&(CmdArgs[0].ToString().ToLower().Equals("/stderr")))
            // Initialize the console trace listener to write
            // trace output to the standard error stream.
        {
            consoleTracer = new ConsoleTraceListener(true);
        }
        else
        {
            // Initialize the console trace listener to write
            // trace output to the standard output stream.
            consoleTracer = new ConsoleTraceListener();
        }
        // Set the name of the trace listener, which helps identify this 
        // particular instance within the trace listener collection.
        consoleTracer.Name = "mainConsoleTracer";

        // Write the initial trace message to the console trace listener.
        consoleTracer.WriteLine(DateTime.Now.ToString()+" ["+consoleTracer.Name+"] - Starting output to trace listener.");

        // Add the new console trace listener to 
        // the collection of trace listeners.
        Trace.Listeners.Add(consoleTracer);

        // Call a local method, which writes information about the current 
        // execution environment to the configured trace listeners.
        WriteEnvironmentInfoToTrace();

        // Write the final trace message to the console trace listener.
        consoleTracer.WriteLine(DateTime.Now.ToString()+" ["+consoleTracer.Name+"] - Ending output to trace listener.");

        // Flush any pending trace messages, remove the 
        // console trace listener from the collection,
        // and close the console trace listener.
        Trace.Flush();
        Trace.Listeners.Remove(consoleTracer);
        consoleTracer.Close();

        // Write a final trace message to all trace listeners.
        Trace.WriteLine(DateTime.Now.ToString()+" - End of Main");

        // Close all other configured trace listeners.
        Trace.Close();

    }

}

.NET Framework
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: