Ағылшын тілінде оқу

Бөлісу құралы:


TraceSwitch.Level Свойство

Определение

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

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

Значение свойства

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

Исключения

Для свойства Level установлено значение, которое не является одним из значений TraceLevel.

Примеры

В следующем примере кода создается новый TraceSwitch объект и используется параметр для определения того, следует ли выводить сообщения об ошибках. Параметр создается на уровне класса. MyMethod записывает первое сообщение об ошибке, Level если свойство имеет значение TraceLevel.Error или выше. Однако не записывает второе сообщение об ошибкеLevel, MyMethod если меньше 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();
}

Комментарии

Для платформа .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>  

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

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

При задании этого свойства свойства обновляются TraceErrorсвойства , TraceWarning, TraceInfoи TraceVerbose в соответствии с новым значением.

Применяется к

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