Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Trace, classe

Fournit un ensemble de méthodes et de propriétés qui vous permettent de tracer l'exécution de votre code. Cette classe ne peut pas être héritée.

System.Object
  System.Diagnostics.Trace

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

public sealed class Trace

Le type Trace expose les membres suivants.

  NomDescription
Propriété publiqueMembre statiquePris en charge par XNA FrameworkAutoFlushObtient ou définit la nécessité de l'appel à Flush sur Listeners après chaque écriture.
Propriété publiqueMembre statiqueCorrelationManagerObtient le gestionnaire de corrélation pour le thread pour cette trace.
Propriété publiqueMembre statiquePris en charge par XNA FrameworkIndentLevelObtient ou définit le niveau de retrait.
Propriété publiqueMembre statiquePris en charge par XNA FrameworkIndentSizeObtient ou définit le nombre d'espaces dans un retrait.
Propriété publiqueMembre statiquePris en charge par XNA FrameworkListenersObtient la collection des écouteurs qui surveillent la sortie de trace.
Propriété publiqueMembre statiqueUseGlobalLockObtient ou définit une valeur qui indique si le verrouillage global doit être utilisé.
Début

  NomDescription
Méthode publiqueMembre statiquePris en charge par XNA FrameworkAssert(Boolean)Vérifie une condition ; si la condition est false, affiche une boîte de message qui mentionne la pile des appels.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkAssert(Boolean, String)Vérifie une condition ; si la condition est false, affiche un message spécifié et une boîte de message qui mentionne la pile des appels.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkAssert(Boolean, String, String)Vérifie une condition ; si la condition est false, affiche deux messages spécifiés et une boîte de message qui mentionne la pile des appels.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkCloseVide la mémoire tampon de sortie puis ferme Listeners.
Méthode publiquePris en charge par XNA FrameworkEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode publiqueMembre statiquePris en charge par XNA FrameworkFail(String)Émet le message d'erreur spécifié.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkFail(String, String)Envoie un message d'erreur ainsi qu'un message d'erreur détaillé.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkFlushVide la mémoire tampon de sortie et entraîne l'écriture des données dans la mémoire tampon vers les Listeners.
Méthode publiquePris en charge par XNA FrameworkGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueMembre statiqueIndentAugmente d'une unité le IndentLevel actuel.
Méthode publiqueMembre statiqueRefreshActualise les données de configuration de trace.
Méthode publiquePris en charge par XNA FrameworkToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode publiqueMembre statiqueTraceError(String)Écrit un message d'erreur dans les écouteurs de la trace dans la collection Listeners à l'aide du message spécifié.
Méthode publiqueMembre statiqueTraceError(String, Object[])Écrit un message d'erreur dans les écouteurs de la trace dans la collection Listeners à l'aide du tableau spécifié d'objets et des informations de mise en forme.
Méthode publiqueMembre statiqueTraceInformation(String)Écrit un message d'information dans les écouteurs de la trace de la collection Listeners à l'aide du message spécifié.
Méthode publiqueMembre statiqueTraceInformation(String, Object[])Écrit un message d'information dans les écouteurs de la trace de la collection Listeners à l'aide du tableau spécifié d'objets et des informations de mise en forme.
Méthode publiqueMembre statiqueTraceWarning(String)Écrit un message d'avertissement dans les écouteurs de la trace dans la collection Listeners à l'aide du message spécifié.
Méthode publiqueMembre statiqueTraceWarning(String, Object[])Écrit un message d'avertissement dans les écouteurs de la trace dans la collection Listeners à l'aide du tableau spécifié d'objets et des informations de mise en forme.
Méthode publiqueMembre statiqueUnindentDiminue d'une unité le IndentLevel actuel.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWrite(Object)Écrit la valeur de la méthode ToString de l'objet sur les écouteurs de trace dans la collection Listeners.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWrite(String)Écrit un message dans les écouteurs de trace de la collection Listeners.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWrite(Object, String)Écrit un nom de catégorie et la valeur de la méthode ToString de l'objet sur les écouteurs de trace de la collection Listeners.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWrite(String, String)Écrit un nom de catégorie et un message dans les écouteurs de trace de la collection Listeners.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWriteIf(Boolean, Object)Écrit la valeur de la méthode ToString de l'objet sur les écouteurs de trace de la collection Listeners si une condition a la valeur true.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWriteIf(Boolean, String)Écrit un message dans les écouteurs de trace de la collection Listeners si une condition est true.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWriteIf(Boolean, Object, String)Écrit un nom de catégorie ainsi que la valeur de la méthode ToString de l'objet sur les écouteurs de trace de la collection Listeners si une condition a la valeur true.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWriteIf(Boolean, String, String)Écrit un nom de catégorie et un message dans les écouteurs de trace de la collection Listeners si une condition est true.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWriteLine(Object)Écrit la valeur de la méthode ToString de l'objet sur les écouteurs de trace dans la collection Listeners.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWriteLine(String)Écrit un message dans les écouteurs de trace de la collection Listeners.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWriteLine(Object, String)Écrit un nom de catégorie et la valeur de la méthode ToString de l'objet sur les écouteurs de trace de la collection Listeners.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWriteLine(String, String)Écrit un nom de catégorie et un message dans les écouteurs de trace de la collection Listeners.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWriteLineIf(Boolean, Object)Écrit la valeur de la méthode ToString de l'objet sur les écouteurs de trace de la collection Listeners si une condition a la valeur true.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWriteLineIf(Boolean, String)Écrit un message dans les écouteurs de trace de la collection Listeners si une condition est true.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWriteLineIf(Boolean, Object, String)Écrit un nom de catégorie ainsi que la valeur de la méthode ToString de l'objet sur les écouteurs de trace de la collection Listeners si une condition a la valeur true.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkWriteLineIf(Boolean, String, String)Écrit un nom de catégorie et un message dans les écouteurs de trace de la collection Listeners si une condition est true.
Début

Vous pouvez utiliser les propriétés et les méthodes dans la classe Trace pour instrumenter les versions release. L'instrumentation vous permet de surveiller l'état de santé de votre application fonctionnant dans des conditions de paramétrage réelles. Le traçage vous aide à isoler les problèmes et à les résoudre sans affecter un système en cours d'exécution.

Cette classe fournit des méthodes d'affichage d'une boîte de dialogue Assert et permet d'envoyer une assertion qui sera toujours Fail. Cette classe fournit des méthodes d'écriture avec les variations suivantes : Write, WriteLine, WriteIf et WriteLineIf.

Les classes BooleanSwitch et TraceSwitch fournissent des moyens de contrôler de manière dynamique la sortie du traçage. 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, consultez la classe Switch et la rubrique Comment : configurer les commutateurs de trace.

Vous pouvez personnaliser la cible de la sortie du traçage en ajoutant des instances de TraceListener à la collection Listeners, ou en en supprimant. La collection Listeners est partagée par les classes Debug et Trace ; l'ajout d'un écouteur de la trace à l'une ou l'autre de ces classes ajoute l'écouteur aux deux. Par défaut, la sortie de trace est émise à l'aide de la classe DefaultTraceListener.

RemarqueRemarque

L'ajout d'un écouteur de suivi à la collection Listeners peut provoquer qu'une exception soit levée lors du traçage, si une ressource utilisée par l'écouteur de suivi n'est pas disponible. Les conditions et l'exception levée dépendent de l'écouteur de la trace et ne peuvent pas être énumérées dans cette rubrique. Il peut être utile de faire des appels aux méthodes Trace dans des blocs try/catch pour détecter et gérer toutes les exceptions des écouteurs de suivi.

RemarqueRemarque

Si vous ajoutez des écouteurs de la trace au code d'un niveau de confiance partiel, vous obtiendrez une exception SecurityException, parce qu'ajouter des écouteurs de la trace requiert l'autorisation UnmanagedCode. Pour tracer du code partiellement fiable qui exécute dans un sandbox dans Visual Studio, n'ajoutez pas les écouteurs de suivi. À la place, consultez les messages Trace et Debug dans la fenêtre Sortie.

La classe Trace fournit les propriétés pour obtenir ou définir le niveau de Indent et IndentSize et pour indiquer s'il faut AutoFlush après chaque écriture.

Pour définir les paramètres AutoFlush et IndentSize pour Trace, vous pouvez modifier le fichier de configuration correspondant au nom de votre application. Le fichier de configuration doit être mis en forme comme 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 ignorent les appels à ces méthodes sauf si "TRACE" est défini en tant que symbole de compilation conditionnelle. Reportez-vous à la documentation d'un compilateur pour déterminer si ConditionalAttribute est pris en charge et la syntaxe permettant de définir un symbole de compilation conditionnelle.

RemarqueRemarque

Dans les projets Visual Studio, le symbole de compilation conditionnelle "DEBUG" est, par défaut, défini pour les versions debug, et le symbole "TRACE" est défini aussi bien pour les versions debug que pour les versions release. Pour plus d'informations sur la désactivation de ce comportement, consultez la documentation Visual Studio.

Pour définir le symbole de compilation conditionnelle "TRACE" en C#, ajoutez l'option /d:TRACE à la ligne de commande du compilateur lors de la compilation du code sur une ligne de commande, ou ajoutez #define TRACE au début du fichier. En Visual Basic, ajoutez l'option /d:TRACE=True à la ligne de commande de compilateur ou ajoutez #Const TRACE=True au fichier.

ConditionalAttribute n'est pas pris en charge par le compilateur C++. Pour fournir une fonction équivalente, vous devez englober les appels aux méthodes de Trace dans un bloc #if defined(TRACE) ... #endif, et ajouter l'option /DTRACE à la ligne de commande de compilateur ou ajouter #define TRACE au fichier.

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 Trace.Indent et Trace.Unindent pour distinguer la sortie du traçage. Pour obtenir un exemple plus complet de l'utilisation de Trace, consultez Comment : ajouter des instructions de traçage dans le code d'une 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();
    }
}


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ce type est thread-safe.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft