TraceLevel Enumeração
Definição
Especifica quais mensagens serão geradas para as classes Debug, Trace e TraceSwitch.Specifies what messages to output for the Debug, Trace and TraceSwitch classes.
public enum class TraceLevel
public enum TraceLevel
type TraceLevel =
Public Enum TraceLevel
- Herança
Campos
| Error | 1 | Produzir mensagens de tratamento de erros como saída.Output error-handling messages. |
| Info | 3 | Produzir mensagens informativas, avisos e de tratamento de erros como saída.Output informational messages, warnings, and error-handling messages. |
| Off | 0 | Não produzir nenhuma mensagem de rastreamento e depuração como saída.Output no tracing and debugging messages. |
| Verbose | 4 | Produzir todas as mensagens de depuração e rastreamento como saída.Output all debugging and tracing messages. |
| Warning | 2 | Produzir mensagens de avisos e tratamento de erros como saída.Output warnings and error-handling messages. |
Comentários
Essa enumeração é usada pela classe de TraceSwitch .This enumeration is used by the TraceSwitch class.
Você deve habilitar o rastreamento ou a depuração para usar uma opção.You must enable tracing or debugging to use a switch. A sintaxe a seguir é específica do compilador.The following syntax is compiler specific. Se você usar compiladores diferentes de C# ou Visual Basic, consulte a documentação do seu compilador.If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.
Para habilitar a depuração em C#, adicione o
/d:DEBUGsinalizador à linha de comando do compilador ao compilar o código ou você pode adicionar#define DEBUGà parte superior do arquivo.To enable debugging in C#, add the/d:DEBUGflag to the compiler command line when you compile your code, or you can add#define DEBUGto the top of your file. Em Visual Basic, adicione o/d:DEBUG=Truesinalizador à linha de comando do compilador.In Visual Basic, add the/d:DEBUG=Trueflag to the compiler command line.Para habilitar o rastreamento em C#, adicione o
/d:TRACEsinalizador à linha de comando do compilador ao compilar o código ou adicione-o#define TRACEà parte superior do arquivo.To enable tracing in C#, add the/d:TRACEflag to the compiler command line when you compile your code, or add#define TRACEto the top of your file. Em Visual Basic, adicione o/d:TRACE=Truesinalizador à linha de comando do compilador.In Visual Basic, add the/d:TRACE=Trueflag to the compiler command line.
Para obter mais informações sobre como instrumentar seu aplicativo, consulte Debug e Trace .For more information on instrumenting your application, see Debug and Trace.
Observação
No .NET Framework versão 2.0, você pode usar o texto para especificar o valor de uma opção.In the .NET Framework version 2.0, you can use text to specify the value for a switch. Por exemplo, true para uma BooleanSwitch ou o texto que representa um valor de enumeração como Error para uma TraceSwitch.For example, true for a BooleanSwitch or the text representing an enumeration value such as Error for a TraceSwitch. A linha <add name="mySwitch" value="Error" /> é equivalente a <add name="mySwitch" value="1" />.The line <add name="mySwitch" value="Error" /> is equivalent to <add name="mySwitch" value="1" />.
No .NET Framework versões 1,0 e 1,1, os níveis de rastreamento nos arquivos de configuração são definidos usando o valor inteiro correspondente ao membro de enumeração, em vez do próprio membro de enumeração, como demonstra o exemplo a seguir.In the .NET Framework versions 1.0 and 1.1, trace levels in configuration files are set using the integer value corresponding to the enumeration member, rather than the enumeration member itself, as the following example demonstrates.
<configuration>
<system.diagnostics>
<switches>
<add name="mySwitch" value="4" />
</switches>
</system.diagnostics>
</configuration>
Além de definir os níveis de rastreamento usando o valor inteiro da enumeração, os níveis de rastreamento .NET Framework versão 2,0 podem ser definidos usando a representação de texto do valor de enumeração.In addition to setting trace levels using the integer value of the enumeration, the .NET Framework version 2.0 trace levels can be set using the text representation of the enumeration value. Por exemplo, Verbose para um TraceSwitch .For example, Verbose for a TraceSwitch. A linha <add name="mySwitch" value="Verbose" /> é equivalente a <add name="mySwitch" value="4" />.The line <add name="mySwitch" value="Verbose" /> is equivalent to <add name="mySwitch" value="4" />.
A tabela a seguir mostra a relação entre os TraceLevel membros de enumeração e suas entradas de arquivo de configuração correspondentes.The following table shows the relationship between the TraceLevel enumeration members and their corresponding configuration file entries.
| Nível de rastreamento:Trace Level | Valor do arquivo de configuraçãoConfiguration File Value |
|---|---|
| OffOff | 00 |
| ErroError | 11 |
| AvisoWarning | 22 |
| InfoInfo | 33 |
| DetalhadoVerbose | 44 |