TraceListener.TraceOutputOptions Propriedade

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Origem:

TraceListener.cs

Obtém ou define as opções de saída de rastreamento.

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

Valor da propriedade

TraceOptions

Um combinação bit a bit dos valores de enumeração. O padrão é None.

Exceções

ArgumentOutOfRangeException

A operação de conjuntos falhou porque o valor é inválido.

Exemplos

O exemplo a seguir mostra a configuração da TraceOutputOptions propriedade para um ouvinte de rastreamento de console. O ouvinte de rastreamento do console é um dos ouvintes enumerados na propriedade de uma fonte Listeners de rastreamento. Este exemplo de código faz parte de um exemplo maior fornecido para a TraceSource classe .

ts.Listeners["console"].TraceOutputOptions |= TraceOptions.Callstack;

ts.Listeners("console").TraceOutputOptions = ts.Listeners("console").TraceOutputOptions Or TraceOptions.Callstack

Comentários

A TraceOutputOptions propriedade determina o conteúdo opcional da saída de rastreamento. A propriedade pode ser definida no arquivo de configuração ou programaticamente durante a execução para incluir dados adicionais especificamente para uma seção de código. Por exemplo, você pode definir a TraceOutputOptions propriedade para que o ouvinte TraceOptions.Callstack de rastreamento do console adicione informações de pilha de chamadas à saída do rastreamento.

A TraceOptions enumeração não é usada pelas seguintes classes e métodos:

• A EventLogTraceListener classe , porque ela pode fazer com que um grande volume de dados seja gravado no log.

• Os Write métodos e WriteLine das ConsoleTraceListenerclasses , DefaultTraceListenere TextWriterTraceListener .

• Os Write métodos e WriteLine da TraceListener classe quando eles não são substituídos em uma classe derivada.