TraceSwitch.Level 屬性

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

屬性值

TraceLevel其中一個值是用來指定交換器允許的訊息等級。

例外狀況

範例

下列程式代碼範例會建立新的 TraceSwitch，並使用 參數來判斷是否要列印錯誤訊息。 參數會在類別層級建立。 如果 MyMethod 屬性設定為 Level 或更新版本，TraceLevel.Error 會寫入第一個錯誤訊息。 不過，如果 MyMethod 小於 Level，TraceLevel.Verbose 不會寫入第二個錯誤訊息。

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

備註

對於 .NET Framework 應用程式，要設定你的 TraceSwitch，請編輯與應用程式名稱對應的設定檔。 在這個檔案中，你可以新增一個開關並設定其值、移除一個開關，或清除應用程式先前設定的所有開關。 設定檔格式應如以下範例：

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

你也可以用文字來指定開關的數值。 例如， true 對於 或 BooleanSwitch 表示列舉值的文本，例如 ErrorTraceSwitch。 該直線 <add name="mySwitch" value="Error" /> 等價於 <add name="mySwitch" value="1" />。

屬性的 Level 預設值為 TraceLevel.Off。 或者，對於 .NET Framework 應用程式，等級則可從設定檔取得（若有的話）。

設定此屬性會更新 TraceError、 TraceWarning、 TraceInfo和 TraceVerbose 屬性以反映新值。

另請參閱

• TraceSwitch
• TraceLevel
• Switch
• Debug
• Trace