TraceSwitch Oluşturucular

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.TraceSource.dll

TraceSwitch sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

TraceSwitch(String, String)	Belirtilen görünen adı ve açıklamayı TraceSwitch kullanarak sınıfının yeni bir örneğini başlatır.
TraceSwitch(String, String, String)	Anahtar için belirtilen görünen adı, açıklamayı TraceSwitch ve varsayılan değeri kullanarak sınıfın yeni bir örneğini başlatır.

TraceSwitch(String, String)

Kaynak:

TraceSwitch.cs

Belirtilen görünen adı ve açıklamayı TraceSwitch kullanarak sınıfının yeni bir örneğini başlatır.

public:
 TraceSwitch(System::String ^ displayName, System::String ^ description);

public TraceSwitch (string displayName, string? description);

new System.Diagnostics.TraceSwitch : string * string -> System.Diagnostics.TraceSwitch

Public Sub New (displayName As String, description As String)

Parametreler

displayName

String

Kullanıcı arabiriminde görüntülenecek ad.

description

String

Anahtarın açıklaması.

Örnekler

Aşağıdaki kod örneği yeni TraceSwitch bir oluşturur ve hata iletilerinin yazdırılıp yazdırılmayacağını belirlemek için anahtarını kullanır. 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( "General", "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("General", "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("General", "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 uygulamalarında, 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="1" />  
    </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" />.

Uygulamanızda, aşağıdaki örnekte gösterildiği gibi aynı ada sahip bir TraceSwitch oluşturarak yapılandırılmış anahtar düzeyini kullanabilirsiniz:

private:
    static TraceSwitch^ appSwitch = gcnew TraceSwitch("mySwitch",
        "Switch in config file");

public:
    static void Main(array<String^>^ args)
    {
        //...
        Console::WriteLine("Trace switch {0} configured as {1}",
        appSwitch->DisplayName, appSwitch->Level.ToString());
        if (appSwitch->TraceError)
        {
            //...
        }
    }

private static TraceSwitch appSwitch = new TraceSwitch("mySwitch",
    "Switch in config file");

public static void Main(string[] args)
{
    //...
    Console.WriteLine("Trace switch {0} configured as {1}",
    appSwitch.DisplayName, appSwitch.Level.ToString());
    if (appSwitch.TraceError)
    {
        //...
    }
}

Private Shared appSwitch As new TraceSwitch("mySwitch", _
    "Switch in config file")

Public Shared Sub Main(args As String())
    '...
    Console.WriteLine("Trace switch {0} configured as {1}",
    appSwitch.DisplayName, appSwitch.Level.ToString())
    If appSwitch.TraceError = True  Then
        '...
    End If
End Sub

Bu oluşturucu, yeni anahtarın özelliğini olarak TraceLevel.OffayarlarLevel. Alternatif olarak, .NET Framework uygulamalar için, varsa, anahtar ayarları yapılandırma dosyasından alınır.

TraceSwitch sınıfı, anahtarın TraceErrortest Level etmek için , TraceWarning, TraceInfove TraceVerbose özelliklerini sağlar. Level özelliği anahtarını TraceLevelalır veya ayarlar.

Not

Performansı geliştirmek için sınıfınızda üye static oluşturabilirsinizTraceSwitch.

Ayrıca bkz.

• TraceSwitch
• TraceLevel
• Switch
• Debug
• Trace

TraceSwitch(String, String, String)

Kaynak:

TraceSwitch.cs

Anahtar için belirtilen görünen adı, açıklamayı TraceSwitch ve varsayılan değeri kullanarak sınıfın yeni bir örneğini başlatır.

public:
 TraceSwitch(System::String ^ displayName, System::String ^ description, System::String ^ defaultSwitchValue);

public TraceSwitch (string displayName, string? description, string defaultSwitchValue);

new System.Diagnostics.TraceSwitch : string * string * string -> System.Diagnostics.TraceSwitch

Public Sub New (displayName As String, description As String, defaultSwitchValue As String)

Parametreler

displayName

String

Kullanıcı arabiriminde görüntülenecek ad.

description

String

Anahtarın açıklaması.

defaultSwitchValue

String

Anahtarın varsayılan değeri.

Açıklamalar

displayName parametresi özelliğin değerini DisplayName ayarlamak için kullanılır, description parametre özelliğin Description değerini ayarlamak için kullanılır ve defaultSwitchValue parametre bir alan olarak kaydedilir ve özelliği ilk başvuruda başlatmak Value için kullanılır. TraceSwitch(String, String) Daha fazla bilgi ve kod örneği için oluşturucuya bakın.