TraceOptions Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Specifica le opzioni di dati di traccia da scrivere nell'output di traccia.
Questa enumerazione supporta una combinazione bit per bit dei rispettivi valori dei membri.
public enum class TraceOptions[System.Flags]
public enum TraceOptions[<System.Flags>]
type TraceOptions = Public Enum TraceOptions- Ereditarietà
- Attributi
Campi
| Nome | Valore | Descrizione |
|---|---|---|
| None | 0 | Non scrivere elementi. |
| LogicalOperationStack | 1 | Scrivere lo stack di operazioni logiche, rappresentato dal valore restituito della LogicalOperationStack proprietà . |
| DateTime | 2 | Scrivere la data e l'ora. |
| Timestamp | 4 | Scrivere il timestamp, rappresentato dal valore restituito del GetTimestamp() metodo . |
| ProcessId | 8 | Scrivere l'identità del processo, rappresentata dal valore restituito della Id proprietà . |
| ThreadId | 16 | Scrivere l'identità del thread, rappresentata dal valore restituito della ManagedThreadId proprietà per il thread corrente. |
| Callstack | 32 | Scrivere lo stack di chiamate, rappresentato dal valore restituito della StackTrace proprietà . |
Esempio
Nell'esempio di codice seguente viene illustrato l'uso dell'enumerazione TraceOptions per impostare la TraceOutputOptions proprietà a livello di codice per un listener di traccia della console. Il listener di traccia della console è uno dei listener enumerati nella Listeners proprietà di un'origine di traccia. Questo esempio di codice fa parte di un esempio più ampio fornito per la TraceSource classe .
ts.Listeners["console"].TraceOutputOptions |= TraceOptions.Callstack;
ts.Listeners("console").TraceOutputOptions = ts.Listeners("console").TraceOutputOptions Or TraceOptions.Callstack
Commenti
Questa enumerazione viene utilizzata dai listener di traccia per determinare quali opzioni, o elementi, devono essere inclusi nell'output di traccia. I listener di traccia archiviano le opzioni di traccia nella TraceOutputOptions proprietà .
Nell'esempio seguente viene illustrato l'uso dell'attributo traceOutputOptions per specificare le opzioni di output di traccia per un oggetto ConsoleTraceListener. L'uso di un file di configurazione simile a questo è possibile solo nelle app .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>
Per informazioni dettagliate sull'aggiunta di listener di traccia al file di configurazione dell'applicazione, vedere <listener>.
L'enumerazione TraceOptions non viene utilizzata dalle classi e dai metodi seguenti:
La EventLogTraceListener classe , perché può causare la scrittura di un volume elevato di dati nel log.
Metodi
WriteeWriteLinedelle ConsoleTraceListenerclassi , DefaultTraceListenere TextWriterTraceListener .I Write metodi e WriteLine della TraceListener classe quando non vengono sottoposti a override in una classe derivata.
