TraceOptions Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica as opções de dados de rastreamento a serem gravadas na saída do 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
- Atributos
Campos
| Nome | Valor | Description |
|---|---|---|
| None | 0 | Não escreva elementos. |
| LogicalOperationStack | 1 | Escreva a pilha de operações lógicas, que é representada pelo valor retornado da LogicalOperationStack propriedade. |
| DateTime | 2 | Escreva a data e a hora. |
| Timestamp | 4 | Escreva o carimbo de data/hora, que é representado pelo valor retornado do GetTimestamp() método. |
| ProcessId | 8 | Escreva a identidade do processo, que é representada pelo valor retornado da Id propriedade. |
| ThreadId | 16 | Escreva a identidade do thread, que é representada pelo valor retornado da ManagedThreadId propriedade para o thread atual. |
| Callstack | 32 | Escreva a pilha de chamadas, que é representada pelo valor retornado da StackTrace propriedade. |
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 de 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 do .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 <os 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
Writemétodos eWriteLineos métodos das ConsoleTraceListenerclasses e TextWriterTraceListener . DefaultTraceListenerOs Write métodos e WriteLine os métodos da TraceListener classe quando não são substituídos em uma classe derivada.
