Partager via


TraceOptions Énumération

Définition

Spécifie les 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
TraceOptions
Attributs

Champs

Nom Valeur Description
None 0

N’écrivez aucun élément.

LogicalOperationStack 1

Écrivez la pile d’opérations logiques, représentée par la valeur de retour de la LogicalOperationStack propriété.

DateTime 2

Écrivez la date et l’heure.

Timestamp 4

Écrivez l’horodatage, qui est représenté par la valeur de retour de la GetTimestamp() méthode.

ProcessId 8

Écrivez l’identité du processus, qui est représentée par la valeur de retour de la Id propriété.

ThreadId 16

Écrivez l’identité de thread, qui est représentée par la valeur de retour de la ManagedThreadId propriété pour le thread actuel.

Callstack 32

Écrivez la pile des appels, qui est représentée par la valeur de retour de la StackTrace propriété.

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 montre l’utilisation de l’attribut traceOutputOptions pour spécifier les options de sortie de trace d’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 <les écouteurs>.

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

S’applique à