TraceSwitch Konstruktor

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.TraceSource.dll

Menginisialisasi instans baru kelas TraceSwitch.

Overload

TraceSwitch(String, String)	Menginisialisasi instans TraceSwitch baru kelas, menggunakan nama dan deskripsi tampilan yang ditentukan.
TraceSwitch(String, String, String)	Menginisialisasi instans TraceSwitch baru kelas, menggunakan nama tampilan, deskripsi, dan nilai default yang ditentukan untuk sakelar.

TraceSwitch(String, String)

Sumber:

TraceSwitch.cs

Menginisialisasi instans TraceSwitch baru kelas, menggunakan nama dan deskripsi tampilan yang ditentukan.

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)

Parameter

displayName

String

Nama yang akan ditampilkan pada antarmuka pengguna.

description

String

Deskripsi sakelar.

Contoh

Contoh kode berikut membuat baru TraceSwitch dan menggunakan sakelar untuk menentukan apakah akan mencetak pesan kesalahan. Sakelar dibuat di tingkat kelas. MyMethod menulis pesan kesalahan pertama jika Level properti diatur ke TraceLevel.Error atau lebih tinggi. Namun, MyMethod tidak menulis pesan kesalahan kedua jika Level kurang dari TraceLevel.Verbose.

   // 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

Keterangan

Untuk .NET Framework aplikasi, untuk mengatur tingkat AndaTraceSwitch, edit file konfigurasi yang sesuai dengan nama aplikasi Anda. Dalam file ini, Anda dapat menambahkan sakelar dan mengatur nilainya, menghapus sakelar, atau menghapus semua sakelar yang sebelumnya diatur oleh aplikasi. File konfigurasi harus diformat seperti contoh berikut:

<configuration>  
  <system.diagnostics>  
    <switches>  
      <add name="mySwitch" value="1" />  
    </switches>  
  </system.diagnostics>  
</configuration>  

Anda juga dapat menggunakan teks untuk menentukan nilai pengalih. Misalnya, true untuk BooleanSwitch atau teks yang mewakili nilai enumerasi, seperti Error untuk TraceSwitch. Baris <add name="mySwitch" value="Error" /> sama dengan <add name="mySwitch" value="1" />.

Dalam aplikasi, Anda dapat menggunakan tingkat sakelar yang dikonfigurasi dengan membuat TraceSwitch dengan nama yang sama, seperti yang ditunjukkan dalam contoh berikut:

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

Konstruktor ini mengatur Level properti sakelar baru ke TraceLevel.Off. Atau, untuk aplikasi .NET Framework, pengaturan pengalihan diperoleh dari file konfigurasi, jika tersedia.

Kelas TraceSwitch menyediakan TraceErrorproperti , TraceWarning, TraceInfo, dan TraceVerbose untuk menguji Level sakelar. Properti Level mendapatkan atau mengatur sakelar TraceLevel.

Catatan

Untuk meningkatkan performa, Anda dapat membuat TraceSwitch anggota static di kelas Anda.

Lihat juga

• TraceSwitch
• TraceLevel
• Switch
• Debug
• Trace

TraceSwitch(String, String, String)

Sumber:

TraceSwitch.cs

Menginisialisasi instans TraceSwitch baru kelas, menggunakan nama tampilan, deskripsi, dan nilai default yang ditentukan untuk sakelar.

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)

Parameter

displayName

String

Nama yang akan ditampilkan pada antarmuka pengguna.

description

String

Deskripsi sakelar.

defaultSwitchValue

String

Nilai default sakelar.

Keterangan

Parameter displayName digunakan untuk mengatur nilai DisplayName properti, description parameter digunakan untuk mengatur nilai Description properti, dan defaultSwitchValue parameter disimpan sebagai bidang dan digunakan untuk menginisialisasi Value properti pada referensi pertama. TraceSwitch(String, String) Lihat konstruktor untuk informasi selengkapnya dan contoh kode.