TraceSwitch.Level Свойство

Определение

Пространство имен:

System.Diagnostics

Сборки:

netstandard.dll, System.Diagnostics.TraceSource.dll

Исходный код:

TraceSwitch.cs

Возвращает или задает уровень трассировки, определяющий сообщения, которые разрешает переключатель.

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

Одно из TraceLevel значений, указывающее уровень сообщений, разрешенных параметром.

Исключения

ArgumentException

Level имеет значение, которое не является одним из значений 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

Комментарии

Чтобы задать уровень TraceSwitchприложений .NET Framework, измените файл конфигурации, соответствующий имени приложения. В этом файле можно добавить переключатель и задать его значение, удалить переключатель или очистить все параметры, заданные приложением ранее. Файл конфигурации должен быть отформатирован следующим образом:

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

Можно также использовать текст для указания значения переключателя. Например, true для BooleanSwitch текста, представляющего значение перечисления, например Error для объекта TraceSwitch. Строка <add name="mySwitch" value="Error" /> эквивалентна <add name="mySwitch" value="1" />.

Значение свойства Level по умолчанию: TraceLevel.Off. Кроме того, для приложений .NET Framework уровень получается из файла конфигурации, если он доступен.

Установка этого свойства обновляет TraceErrorсвойства , TraceWarningTraceInfoи TraceVerbose свойства, чтобы отразить новое значение.

См. также раздел

• TraceSwitch
• TraceLevel
• Switch
• Debug
• Trace