TraceSwitch.Level Özellik

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.TraceSource.dll

Kaynak:

TraceSwitch.cs

Anahtarın izin verdiği iletileri belirleyen izleme düzeyini alır veya ayarlar.

public:
 property System::Diagnostics::TraceLevel Level { System::Diagnostics::TraceLevel get(); void set(System::Diagnostics::TraceLevel value); };

public System.Diagnostics.TraceLevel Level { get; set; }

member this.Level : System.Diagnostics.TraceLevel with get, set

Public Property Level As TraceLevel

Özellik Değeri

TraceLevel

TraceLevel Anahtar tarafından izin verilen ileti düzeyini belirten değerlerden biri.

Özel durumlar

ArgumentException

Level , değerlerden biri olmayan bir değere TraceLevel ayarlanır.

Örnekler

Aşağıdaki kod örneği yeni TraceSwitch bir oluşturur ve anahtarı kullanarak hata iletilerinin yazdırılıp yazdırılmayacağını belirler. Anahtar, sınıf düzeyinde oluşturulur. MyMethod özelliği veya daha yüksek olarak ayarlandıysa LevelTraceLevel.Error ilk hata iletisini yazar. Ancak, MyMethod değerinden küçükse LevelTraceLevel.Verboseikinci hata iletisini yazmaz.

   // Class-level declaration.
   /* Create a TraceSwitch to use in the entire application.*/
private:
   static TraceSwitch^ mySwitch = gcnew TraceSwitch( "mySwitch","Entire Application" );

public:
   static void MyMethod()
   {
      // Write the message if the TraceSwitch level is set to Error or higher.
      if ( mySwitch->TraceError )
            Console::WriteLine( "My error message." );

      // Write the message if the TraceSwitch level is set to Verbose.
      if ( mySwitch->TraceVerbose )
            Console::WriteLine( "My second error message." );
   }

   static void main()
   {
      // Run the method that prints error messages based on the switch level.
      MyMethod();
   }

//Class-level declaration.
/* Create a TraceSwitch to use in the entire application.*/

static TraceSwitch mySwitch = new TraceSwitch("mySwitch", "Entire Application");

static public void MyMethod()
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    if (mySwitch.TraceError)
        Console.WriteLine("My error message.");

    // Write the message if the TraceSwitch level is set to Verbose.
    if (mySwitch.TraceVerbose)
        Console.WriteLine("My second error message.");
}

public static void Main(string[] args)
{
    // Run the method that prints error messages based on the switch level.
    MyMethod();
}

' Class-level declaration.
' Create a TraceSwitch to use in the entire application. 

Private Shared mySwitch As New TraceSwitch("mySwitch", "Entire Application")

Public Shared Sub MyMethod()
    ' Write the message if the TraceSwitch level is set to Error or higher.
    If mySwitch.TraceError Then
        Console.WriteLine("My error message.")
    End If 
    ' Write the message if the TraceSwitch level is set to Verbose.
    If mySwitch.TraceVerbose Then
        Console.WriteLine("My second error message.")
    End If
End Sub

Public Shared Sub Main()
    ' Run the method that prints error messages based on the switch level.
    MyMethod()
End Sub

Açıklamalar

.NET Framework uygulamalarda, düzeyinizi TraceSwitchayarlamak için uygulamanızın adına karşılık gelen yapılandırma dosyasını düzenleyin. Bu dosyada, bir anahtar ekleyebilir ve değerini ayarlayabilir, bir anahtarı kaldırabilir veya uygulama tarafından daha önce ayarlanan tüm anahtarları temizleyebilirsiniz. Yapılandırma dosyası aşağıdaki örnekte olduğu gibi biçimlendirilmelidir:

<configuration>  
  <system.diagnostics>  
    <switches>  
      <add name="mySwitch" value="0" />  
      <add name="myNewSwitch" value="3" />  
      <remove name="mySwitch" />  
      <clear/>  
    </switches>  
  </system.diagnostics>  
</configuration>  

Anahtarın değerini belirtmek için metin de kullanabilirsiniz. Örneğin, true bir BooleanSwitch sabit listesi değerini temsil eden bir veya metni için, örneğin Error için TraceSwitch. satırı <add name="mySwitch" value="Error" /> ile eşdeğerdir <add name="mySwitch" value="1" />.

özelliğinin Level varsayılan değeri şeklindedir TraceLevel.Off. Veya .NET Framework uygulamalar için düzey, varsa yapılandırma dosyasından alınır.

Bu özelliğin TraceErrorayarlanması, , TraceWarning, TraceInfove TraceVerbose özelliklerini yeni değeri yansıtacak şekilde güncelleştirir.

Ayrıca bkz.

• TraceSwitch
• TraceLevel
• Switch
• Debug
• Trace