TraceSwitch.Level Propriedade

Definição

Espaço de Nomes:

System.Diagnostics

Assemblagem:

System.dll

Obtém ou define o nível de traço que determina as mensagens que o switch permite.

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

Valor de Propriedade

TraceLevel

Um dos TraceLevel valores que especifica o nível de mensagens permitidas pelo comutador.

Exceções

ArgumentException

Level é definido para um valor que não é um dos TraceLevel valores.

Exemplos

O exemplo de código seguinte cria um novo TraceSwitch e usa o interruptor para determinar se deve imprimir mensagens de erro. A troca é criada ao nível da turma. MyMethod escreve a primeira mensagem de erro se a Level propriedade estiver definida como TraceLevel.Error ou superior. No entanto, MyMethod não escreve a segunda mensagem de erro se o Level for menor que 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

Observações

Para .NET aplicações Framework, para definir o nível do teu TraceSwitch, edita o ficheiro de configuração que corresponde ao nome da tua aplicação. Neste ficheiro, pode adicionar um interruptor e definir o seu valor, remover um interruptor ou apagar todos os interruptores previamente definidos pela aplicação. O ficheiro de configuração deve ser formatado como o seguinte exemplo:

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

Também podes usar texto para especificar o valor de um interruptor. Por exemplo, true para um BooleanSwitch ou o texto que representa um valor de enumeração, como Error para um TraceSwitch. A reta <add name="mySwitch" value="Error" /> é equivalente a <add name="mySwitch" value="1" />.

O valor padrão da Level propriedade é TraceLevel.Off. Ou, para aplicações do .NET Framework, o nível é obtido a partir do ficheiro de configuração, se disponível.

Definir esta propriedade atualiza as TraceErrorpropriedades , TraceWarning, TraceInfo, e TraceVerbose para refletir o novo valor.

Ver também

• TraceSwitch
• TraceLevel
• Switch
• Debug
• Trace