TraceLevel Wyliczenie

Definicja

Określa, jakie komunikaty mają być wyprowadzane przez Debug Trace klasy, i 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
Dziedziczenie
TraceLevel

Pola

Error 1

Wyjściowe komunikaty obsługi błędów.Output error-handling messages.

Info 3

Wyjściowe komunikaty informacyjne, ostrzeżenia i komunikaty obsługi błędów.Output informational messages, warnings, and error-handling messages.

Off 0

Wyprowadzanie braku komunikatów śledzenia i debugowania.Output no tracing and debugging messages.

Verbose 4

Wyprowadza wszystkie komunikaty debugowania i śledzenia.Output all debugging and tracing messages.

Warning 2

Ostrzeżenia wyjściowe i komunikaty obsługi błędów.Output warnings and error-handling messages.

Uwagi

To wyliczenie jest używane przez TraceSwitch klasę.This enumeration is used by the TraceSwitch class.

Musisz włączyć śledzenie lub debugowanie, aby użyć przełącznika.You must enable tracing or debugging to use a switch. Następująca składnia jest specyficzna dla kompilatora.The following syntax is compiler specific. Jeśli używasz kompilatorów innych niż C# lub Visual Basic, zapoznaj się z dokumentacją kompilatora.If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.

  • Aby włączyć debugowanie w języku C#, Dodaj /d:DEBUG flagę do wiersza polecenia kompilatora podczas kompilowania kodu lub możesz dodać #define DEBUG do góry pliku.To enable debugging in C#, add the /d:DEBUG flag to the compiler command line when you compile your code, or you can add #define DEBUG to the top of your file. W Visual Basic Dodaj /d:DEBUG=True flagę do wiersza polecenia kompilatora.In Visual Basic, add the /d:DEBUG=True flag to the compiler command line.

  • Aby włączyć śledzenie w języku C#, Dodaj /d:TRACE flagę do wiersza polecenia kompilatora podczas kompilowania kodu lub Dodaj #define TRACE do góry pliku.To enable tracing in C#, add the /d:TRACE flag to the compiler command line when you compile your code, or add #define TRACE to the top of your file. W Visual Basic Dodaj /d:TRACE=True flagę do wiersza polecenia kompilatora.In Visual Basic, add the /d:TRACE=True flag to the compiler command line.

Aby uzyskać więcej informacji na temat Instrumentacji aplikacji, zobacz Debug i Trace .For more information on instrumenting your application, see Debug and Trace.

Uwaga

W .NET Framework w wersji 2,0 można użyć tekstu, aby określić wartość dla przełącznika.In the .NET Framework version 2.0, you can use text to specify the value for a switch. Na przykład true dla BooleanSwitch lub tekst reprezentujący wartość wyliczenia, Error na przykład dla elementu TraceSwitch .For example, true for a BooleanSwitch or the text representing an enumeration value such as Error for a TraceSwitch. Wiersz <add name="mySwitch" value="Error" /> jest odpowiednikiem <add name="mySwitch" value="1" /> .The line <add name="mySwitch" value="Error" /> is equivalent to <add name="mySwitch" value="1" />.

W .NET Framework wersje 1,0 i 1,1 poziomy śledzenia w plikach konfiguracyjnych są ustawiane przy użyciu wartości całkowitej odpowiadającej elementowi członkowskiemu wyliczenia, a nie elementu członkowskiego wyliczenia, jak pokazano w poniższym przykładzie.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>  

Oprócz ustawiania poziomów śledzenia przy użyciu wartości całkowitej wyliczenia można ustawić poziomy śledzenia .NET Framework w wersji 2,0 przy użyciu tekstowej reprezentacji wartości wyliczenia.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. Na przykład Verbose dla elementu TraceSwitch .For example, Verbose for a TraceSwitch. Wiersz <add name="mySwitch" value="Verbose" /> jest odpowiednikiem <add name="mySwitch" value="4" /> .The line <add name="mySwitch" value="Verbose" /> is equivalent to <add name="mySwitch" value="4" />.

W poniższej tabeli przedstawiono relacje między TraceLevel elementami członkowskimi wyliczenia i ich odpowiednimi wpisami w pliku konfiguracji.The following table shows the relationship between the TraceLevel enumeration members and their corresponding configuration file entries.

Poziom śledzeniaTrace Level Wartość pliku konfiguracjiConfiguration File Value
WyłączoneOff 00
BłądError 11
OstrzeżenieWarning 22
InfoInfo 33
PełnyVerbose 44

Dotyczy

Zobacz też