TraceSwitch.Level Свойство

Определение

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

System.Diagnostics

Сборка:

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 или выше. Однако не записывает второе сообщение об ошибкеLevel, MyMethod если меньше TraceLevel.Verbose.

   // Class-level declaration.
   /* Create a TraceSwitch to use in the entire application.*/
private:
   static TraceSwitch^ mySwitch = gcnew TraceSwitch( "mySwitch","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("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>  

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

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

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

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

• TraceSwitch
• TraceLevel
• Switch
• Debug
• Trace