TraceOptions Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- 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 :
La EventLogTraceListener classe, car elle peut entraîner l’écriture d’un grand volume de données dans le journal.
Méthodes
Writeet méthodes des ConsoleTraceListenerclasses , DefaultTraceListeneret TextWriterTraceListenerWriteLineMéthodes Write et WriteLine méthodes de la TraceListener classe lorsqu’elles ne sont pas substituées dans une classe dérivée.