TraceListener.TraceOutputOptions Proprietà

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Origine:

TraceListener.cs

Ottiene o imposta le opzioni dell'output di traccia.

public:
 property System::Diagnostics::TraceOptions TraceOutputOptions { System::Diagnostics::TraceOptions get(); void set(System::Diagnostics::TraceOptions value); };

public System.Diagnostics.TraceOptions TraceOutputOptions { get; set; }

member this.TraceOutputOptions : System.Diagnostics.TraceOptions with get, set

Public Property TraceOutputOptions As TraceOptions

Valore della proprietà

TraceOptions

Combinazione bit per bit dei valori dell'enumerazione. Il valore predefinito è None.

Eccezioni

ArgumentOutOfRangeException

L'operazione impostata non è riuscita perché il valore non è valido.

Esempio

Nell'esempio seguente viene illustrata l'impostazione TraceOutputOptions della 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

La TraceOutputOptions proprietà determina il contenuto facoltativo dell'output di traccia. La proprietà può essere impostata nel file di configurazione o a livello di codice per includere dati aggiuntivi in modo specifico per una sezione di codice. Ad esempio, è possibile impostare la TraceOutputOptions proprietà per il listener di traccia della console per TraceOptions.Callstack aggiungere informazioni sullo stack di chiamate all'output di traccia.

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 Write e WriteLine delle ConsoleTraceListenerclassi , DefaultTraceListenere TextWriterTraceListener .

• I Write metodi e WriteLine della TraceListener classe quando non vengono sottoposti a override in una classe derivata.