TraceOptions Enumeração

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Especifica opções de dados de rastreamento a serem gravados na saída de rastreamento.

Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.

public enum class TraceOptions

[System.Flags]
public enum TraceOptions

[<System.Flags>]
type TraceOptions = 

Public Enum TraceOptions

Herança

Object

ValueType

Enum

TraceOptions

Atributos

FlagsAttribute

Campos

Callstack	32	Grave a pilha de chamadas, que é representada pelo valor retornado da propriedade StackTrace.
DateTime	2	Grave a data e hora.
LogicalOperationStack	1	Grave a pilha de operação lógica, que é representada pelo valor retornado da propriedade LogicalOperationStack.
None	0	Não grave todos os elementos.
ProcessId	8	Grave a identidade do processo, que é representada pelo valor retornado da propriedade Id.
ThreadId	16	Grave a identidade do thread, que é representada pelo valor retornado da propriedade ManagedThreadId para o thread atual.
Timestamp	4	Grave o carimbo de data/hora, que é representado pelo valor retornado do método GetTimestamp().

Exemplos

O exemplo de código a seguir mostra o uso da TraceOptions enumeração para definir programaticamente a 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

Essa enumeração é usada por ouvintes de rastreamento para determinar quais opções ou elementos devem ser incluídos na saída do rastreamento. Os ouvintes de rastreamento armazenam as opções de rastreamento na TraceOutputOptions propriedade .

O exemplo a seguir mostra o uso do traceOutputOptions atributo para especificar as opções de saída de rastreamento para um ConsoleTraceListener. Usar um arquivo de configuração como esse só é possível em aplicativos .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>  

Para obter detalhes sobre como adicionar ouvintes de rastreamento ao arquivo de configuração do aplicativo, consulte <ouvintes>.

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.