TraceOptions Enumeração
Definição
Especifica opções de dados de rastreamento a serem gravados na saída de rastreamento.Specifies trace data options to be written to the trace output.
Esta enumeração tem um atributo FlagsAttribute que permite uma combinação bit a bit dos valores membros dela.
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.Write the call stack, which is represented by the return value of the StackTrace property. |
| DateTime | 2 | Grave a data e hora.Write the date and time. |
| LogicalOperationStack | 1 | Grave a pilha de operação lógica, que é representada pelo valor retornado da propriedade LogicalOperationStack.Write the logical operation stack, which is represented by the return value of the LogicalOperationStack property. |
| None | 0 | Não grave todos os elementos.Do not write any elements. |
| ProcessId | 8 | Grave a identidade do processo, que é representada pelo valor retornado da propriedade Id.Write the process identity, which is represented by the return value of the Id property. |
| ThreadId | 16 | Grave a identidade do thread, que é representada pelo valor retornado da propriedade ManagedThreadId para o thread atual.Write the thread identity, which is represented by the return value of the ManagedThreadId property for the current thread. |
| Timestamp | 4 | Grave o carimbo de data/hora, que é representado pelo valor retornado do método GetTimestamp().Write the timestamp, which is represented by the return value of the GetTimestamp() method. |
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 do console.The following code example shows the use of the TraceOptions enumeration to programmatically set the TraceOutputOptions property for a console trace listener. O ouvinte de rastreamento do console é um dos ouvintes enumerados na Listeners propriedade de uma origem de rastreamento.The console trace listener is one of the listeners enumerated in the Listeners property of a trace source. Este exemplo de código faz parte de um exemplo maior fornecido para a TraceSource classe.This code example is part of a larger example provided for the TraceSource class.
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.This enumeration is used by trace listeners to determine which options, or elements, should be included in the trace output. Os ouvintes de rastreamento armazenam as opções de rastreamento na TraceOutputOptions propriedade.Trace listeners store the trace options in the TraceOutputOptions property.
O exemplo a seguir mostra o uso do traceOutputOptions atributo para especificar as opções de saída de rastreamento para um ConsoleTraceListener que é habilitado usando um arquivo de configuração.The following example shows the use of the traceOutputOptions attribute to specify the trace output options for a ConsoleTraceListener that is enabled using a configuration file.
<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 > .For details about adding trace listeners to the application configuration file, see <listeners>.
A TraceOptions enumeração não é usada pelas seguintes classes e métodos:The TraceOptions enumeration is not used by the following classes and methods:
A EventLogTraceListener classe, pois pode fazer com que um grande volume de dados seja gravado no log.The EventLogTraceListener class, because it can cause a large volume of data to be written to the log.
Os
WriteWriteLinemétodos e das ConsoleTraceListener classes, DefaultTraceListener e TextWriterTraceListener .TheWriteandWriteLinemethods of the ConsoleTraceListener, DefaultTraceListener, and TextWriterTraceListener classes.Os Write WriteLine métodos e da TraceListener classe quando não são substituídos em uma classe derivada.The Write and WriteLine methods of the TraceListener class when they are not overridden in a derived class.