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 relative ai 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
| Callstack | 32 | Scrivere lo stack di chiamate, che è rappresentato dal valore restituito della proprietà StackTrace. |
| DateTime | 2 | Scrivere la data e l'ora. |
| LogicalOperationStack | 1 | Scrivere lo stack di operazioni logiche, che è rappresentato dal valore restituito della proprietà LogicalOperationStack. |
| None | 0 | Non scrivere alcun elemento. |
| ProcessId | 8 | Scrivere l'identità del processo, che è rappresentata dal valore restituito della proprietà Id. |
| ThreadId | 16 | Scrivere l'identità del thread, che è rappresentata dal valore restituito della proprietà ManagedThreadId per il thread corrente. |
| Timestamp | 4 | Scrivere il timestamp, che è rappresentato dal valore restituito del metodo GetTimestamp(). |
Esempio
Nell'esempio di codice seguente viene illustrato l'uso dell'enumerazione TraceOptions per impostare a livello di codice la TraceOutputOptions proprietà per un listener di traccia della console. Il listener di traccia della console è uno dei listener enumerati nella proprietà di un'origine Listeners di traccia. Questo esempio di codice fa parte di un esempio più grande 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 usata dai listener di traccia per determinare quali opzioni, o elementi, devono essere incluse 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 ConsoleTraceListeneroggetto . 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 usata 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.
