Exporter (0) Imprimer
Développer tout
Développer Réduire

TraceOptions, énumération

Mise à jour : novembre 2007

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

Cette énumération possède un attribut FlagsAttribute qui permet la combinaison d'opérations de bits de ses valeurs de membres.

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

[FlagsAttribute]
public enum TraceOptions
/** @attribute FlagsAttribute */
public enum TraceOptions
public enum TraceOptions

Nom de membreDescription
None N'écrivez pas d'éléments.
LogicalOperationStack Écrivez la pile des opérations logiques qui est représentée par la valeur de retour de la propriété CorrelationManager.LogicalOperationStack.
DateTime Écrivez la date et l'heure locales.
Timestamp Écrivez l'horodatage qui est représenté par la valeur de retour de la méthode GetTimestamp.
ProcessId Écrivez l'identité du processus qui est représentée par la valeur de retour de la propriété Process.Id.
ThreadId Écrivez l'identité de thread qui est représentée par la valeur de retour de la propriété Thread.ManagedThreadId pour le thread actuel.
Callstack Écrivez la pile des appels qui est représentée par la valeur de retour de la propriété Environment.StackTrace.

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

L'exemple suivant montre l'utilisation de l'attribut traceOutputOptions pour spécifier les options de sortie de trace pour ConsoleTraceListener qui est activé à l'aide d'un fichier de configuration.

<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 la trace dans le fichier de configuration de l'application, consultez <listeners>, élément de <trace>.

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

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

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


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0

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