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 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
- Atributos
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
Writemétodos eWriteLinedas ConsoleTraceListenerclasses , DefaultTraceListenere TextWriterTraceListener .Os Write métodos e WriteLine da TraceListener classe quando eles não são substituídos em uma classe derivada.
