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 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
- Attributs
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
WriteetWriteLinedes 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.
