TraceOptions Énumération

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Spécifie des options de données de trace à écrire dans la sortie de trace.

Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.

public enum class TraceOptions

[System.Flags]
public enum TraceOptions

[<System.Flags>]
type TraceOptions = 

Public Enum TraceOptions

Héritage

Object

ValueType

Enum

TraceOptions

Attributs

FlagsAttribute

Champs

Callstack	32	Écrivez la pile des appels qui est représentée par la valeur de retour de la propriété StackTrace.
DateTime	2	Écrivez la date et l'heure locales.
LogicalOperationStack	1	Écrivez la pile des opérations logiques qui est représentée par la valeur de retour de la propriété LogicalOperationStack.
None	0	N'écrivez pas d'éléments.
ProcessId	8	Écrivez l'identité du processus qui est représentée par la valeur de retour de la propriété Id.
ThreadId	16	Écrivez l'identité de thread qui est représentée par la valeur de retour de la propriété ManagedThreadId pour le thread actuel.
Timestamp	4	Écrivez l'horodatage qui est représenté par la valeur de retour de la méthode GetTimestamp().

Exemples

L’exemple de code suivant montre l’utilisation de l’énumération TraceOptions pour définir par programmation la TraceOutputOptions propriété d’un écouteur de trace de console. L’écouteur de trace de console est l’un des écouteurs énumérés dans la Listeners propriété d’une source de trace. Cet exemple de code fait partie d’un exemple plus grand fourni pour la TraceSource classe .

ts.Listeners["console"].TraceOutputOptions |= TraceOptions.Callstack;

ts.Listeners("console").TraceOutputOptions = ts.Listeners("console").TraceOutputOptions Or TraceOptions.Callstack

Remarques

Cette énumération est utilisée par les écouteurs de trace pour déterminer quelles options, ou éléments, doivent être inclus dans la sortie de trace. Les écouteurs de trace stockent les options de trace dans la TraceOutputOptions propriété .

L’exemple suivant illustre l’utilisation de l’attribut traceOutputOptions pour spécifier les options de sortie de trace pour un ConsoleTraceListener. L’utilisation d’un fichier de configuration comme celui-ci n’est possible que dans les applications .NET Framework.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="consoleListener"  
          type="System.Diagnostics.ConsoleTraceListener"   
          traceOutputOptions="ProcessId, DateTime" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Pour plus d’informations sur l’ajout d’écouteurs de trace au fichier de configuration de l’application, consultez <écouteurs>.

L’énumération TraceOptions n’est pas utilisée par les classes et méthodes suivantes :

• La EventLogTraceListener classe, car elle peut entraîner l’écriture d’un grand volume de données dans le journal.

• Méthodes Write et WriteLine des ConsoleTraceListenerclasses , DefaultTraceListeneret TextWriterTraceListener .

• Les Write méthodes et WriteLine de la TraceListener classe lorsqu’elles ne sont pas remplacées dans une classe dérivée.