TraceSwitch Construtores

Origem:

TraceSwitch.cs

Origem:

TraceSwitch.cs

Origem:

TraceSwitch.cs

Origem:

TraceSwitch.cs

Origem:

TraceSwitch.cs

public:
 TraceSwitch(System::String ^ displayName, System::String ^ description);

public TraceSwitch(string displayName, string? description);

public TraceSwitch(string displayName, string description);

new System.Diagnostics.TraceSwitch : string * string -> System.Diagnostics.TraceSwitch

Public Sub New (displayName As String, description As String)

Parâmetros

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("General", "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("General", "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="1" />
    </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" />.

Na sua aplicação, pode usar o nível do switch configurado criando um TraceSwitch com o mesmo nome, como mostrado no exemplo seguinte:

private static TraceSwitch appSwitch = new TraceSwitch("mySwitch",
    "Switch in config file");

public static void Main(string[] args)
{
    //...
    Console.WriteLine("Trace switch {0} configured as {1}",
    appSwitch.DisplayName, appSwitch.Level.ToString());
    if (appSwitch.TraceError)
    {
        //...
    }
}

Private Shared appSwitch As new TraceSwitch("mySwitch", _
    "Switch in config file")

Public Shared Sub Main(args As String())
    '...
    Console.WriteLine("Trace switch {0} configured as {1}",
    appSwitch.DisplayName, appSwitch.Level.ToString())
    If appSwitch.TraceError = True  Then
        '...
    End If
End Sub

Este construtor define a Level propriedade do novo switch para TraceLevel.Off. Ou, para aplicações do .NET Framework, as definições do switch são obtidas a partir do ficheiro de configuração, se disponível.

A TraceSwitch classe fornece os TraceError, TraceWarning, TraceInfo, e TraceVerbose propriedades para testar o Level do comutador. A Level propriedade obtém ou define o TraceLevelinterruptor de .

Ver também

• TraceSwitch
• TraceLevel
• Switch
• Debug
• Trace

Origem:

TraceSwitch.cs

Origem:

TraceSwitch.cs

Origem:

TraceSwitch.cs

Origem:

TraceSwitch.cs

Origem:

TraceSwitch.cs

public:
 TraceSwitch(System::String ^ displayName, System::String ^ description, System::String ^ defaultSwitchValue);

public TraceSwitch(string displayName, string? description, string defaultSwitchValue);

public TraceSwitch(string displayName, string description, string defaultSwitchValue);

new System.Diagnostics.TraceSwitch : string * string * string -> System.Diagnostics.TraceSwitch

Public Sub New (displayName As String, description As String, defaultSwitchValue As String)

Parâmetros

Observações

O displayName parâmetro é usado para definir o valor da DisplayName propriedade, o description parâmetro é usado para definir o valor da Description propriedade, e o defaultSwitchValue parâmetro é guardado como um campo e usado para inicializar a Value propriedade na primeira referência. Consulte o TraceSwitch(String, String) construtor para mais informações e um exemplo de código.