TraceOptions Enumeração
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifica opções de dados de traço a serem escritas na saída do traço.
Esta enumeração suporta uma combinação bit-a-bit dos respetivos valores membro.
public enum class TraceOptions[System.Flags]
public enum TraceOptions[<System.Flags>]
type TraceOptions = Public Enum TraceOptions- Herança
- Atributos
Campos
| Name | Valor | Description |
|---|---|---|
| None | 0 | Não escrevas nenhum elemento. |
| LogicalOperationStack | 1 | Escreve a pilha de operações lógicas, que é representada pelo valor de retorno da LogicalOperationStack propriedade. |
| DateTime | 2 | Escreve a data e a hora. |
| Timestamp | 4 | Escreva o carimbo temporal, que é representado pelo valor de retorno do GetTimestamp() método. |
| ProcessId | 8 | Escreva a identidade do processo, que é representada pelo valor de retorno da Id propriedade. |
| ThreadId | 16 | Escreve a identidade da thread, que é representada pelo valor de retorno da ManagedThreadId propriedade para a thread atual. |
| Callstack | 32 | Escreva a pilha de chamadas, que é representada pelo valor de retorno da StackTrace propriedade. |
Exemplos
O exemplo de código seguinte mostra a utilização da TraceOptions enumeração para definir programaticamente a TraceOutputOptions propriedade para um ouvinte de rastreio de consola. O ouvinte de rastreio de consola é um dos ouvintes enumerados na Listeners propriedade de uma fonte de traço. 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
Observações
Esta enumeração é usada pelos ouvintes de traços para determinar quais as opções, ou elementos, que devem ser incluídos na saída do traço. Os ouvintes de rastreamento armazenam as opções de rastreamento na TraceOutputOptions propriedade.
O exemplo seguinte mostra a utilização do traceOutputOptions atributo para especificar as opções de saída de traço para um ConsoleTraceListener. Usar um ficheiro de configuração assim só é possível em aplicações .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 detalhes sobre a adição de ouvintes de rastreamento ao ficheiro de configuração da aplicação, consulte <ouvintes>.
A TraceOptions enumeração não é utilizada pelas seguintes classes e métodos:
A EventLogTraceListener classe, porque pode fazer com que um grande volume de dados seja escrito no log.
Os
Writemétodos eWriteLinedas ConsoleTraceListenerclasses , DefaultTraceListener, e TextWriterTraceListener .Os Write métodos e WriteLine da TraceListener classe quando não são sobrepostos numa classe derivada.