BooleanSwitch Classe

Definição

public ref class BooleanSwitch : System::Diagnostics::Switch

public class BooleanSwitch : System.Diagnostics.Switch

type BooleanSwitch = class
    inherit Switch

Public Class BooleanSwitch
Inherits Switch

Herança

Object

Switch

BooleanSwitch

Exemplos

O exemplo seguinte cria um BooleanSwitch e usa o interruptor para determinar se deve imprimir uma mensagem de erro. Crias o interruptor ao nível da turma. O Main método passa a sua localização para MyMethod, que imprime uma mensagem de erro e indica onde o erro ocorreu.

// Class level declaration.
/* Create a BooleanSwitch for data.*/
static BooleanSwitch dataSwitch = new BooleanSwitch("Data", "DataAccess module");

static public void MyMethod(string location)
{
    //Insert code here to handle processing.
    if (dataSwitch.Enabled)
        Console.WriteLine("Error happened at " + location);
}

public static void Main(string[] args)
{
    //Run the method which writes an error message specifying the location of the error.
    MyMethod("in Main");
}

' Class level declaration.
' Create a BooleanSwitch for data. 
Private Shared dataSwitch As New BooleanSwitch("Data", "DataAccess module")


Public Shared Sub MyMethod(location As String)
    ' Insert code here to handle processing.
    If dataSwitch.Enabled Then
        Console.WriteLine(("Error happened at " + location))
    End If
End Sub

' Entry point which delegates to C-style main function.
Public Overloads Shared Sub Main()
    Main(System.Environment.GetCommandLineArgs())
End Sub
 
Overloads Public Shared Sub Main(args() As String)
    ' Run the method which writes an error message specifying the location of the error.
    MyMethod("in Main")
End Sub

Observações

Pode usar um comutador de rastreamento booleano para ativar ou desativar mensagens consoante a sua importância. Usa a Enabled propriedade para obter o valor atual do switch.

Podes criar um BooleanSwitch no teu código e definir a Enabled propriedade diretamente para instrumentar uma secção específica do código.

Para .NET aplicações Framework, também pode ativar ou desativar um BooleanSwitch através do ficheiro de configuração da aplicação e depois usar o valor configurado BooleanSwitch na sua aplicação. Para configurar um BooleanSwitch, edita o ficheiro de configuração que corresponde ao nome da tua aplicação. Dentro deste ficheiro, pode adicionar ou remover um interruptor, definir o valor de um interruptor ou eliminar 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>

Esta secção de configuração de exemplo define a com a DisplayName propriedade definida como mySwitch e o Enabled valor definido como true.BooleanSwitch Dentro da sua aplicação .NET Framework, pode usar o valor do switch configurado criando um BooleanSwitch com o mesmo nome, como mostrado no seguinte exemplo de código.

private static BooleanSwitch boolSwitch = new BooleanSwitch("mySwitch",
    "Switch in config file");

public static void Main()
{
    //...
    Console.WriteLine("Boolean switch {0} configured as {1}",
        boolSwitch.DisplayName, boolSwitch.Enabled.ToString());
    if (boolSwitch.Enabled)
    {
        //...
    }
}

Private Shared boolSwitch As new BooleanSwitch("mySwitch", _
    "Switch in config file")

Public Shared Sub Main( )
    '...
    Console.WriteLine("Boolean switch {0} configured as {1}",
        boolSwitch.DisplayName, boolSwitch.Enabled.ToString())
    If boolSwitch.Enabled = True Then
        '...
    End If
End Sub

Para .NET aplicações Core e .NET 5+, a propriedade Enabled do novo switch está definida por defeito para false.

Para .NET aplicações Framework, a propriedade Enabled é definida usando o valor especificado no ficheiro de configuração. Configure o switch com valor 0 para definir a Enabled propriedade para false; configure o switch com um valor diferente de zero para definir a Enabled propriedade para true. Se o BooleanSwitch construtor não conseguir encontrar as definições iniciais do comutador no ficheiro de configuração, a Enabled propriedade do novo comutador é definida para false.

Tens de ativar o rastreamento ou depuração para usar um switch. A sintaxe seguinte é específica do compilador. Se usar compiladores que não sejam C# ou Visual Basic, consulte a documentação do seu compilador.

• Para permitir a depuração em C#, adicione a /d:DEBUG flag à linha de comandos do compilador quando compilar o seu código, ou pode adicionar #define DEBUG no topo do seu ficheiro. Em Visual Basic, adicione a flag /d:DEBUG=True à linha de comandos do compilador.

• Para ativar o traçado em C#, adicione a /d:TRACE flag à linha de comandos do compilador quando compilar o seu código, ou adicione #define TRACE no topo do seu ficheiro. Em Visual Basic, adicione a flag /d:TRACE=True à linha de comandos do compilador.

Para mais informações sobre a instrumentação da sua aplicação, consulte Debug e Trace. Para mais informações sobre a configuração e utilização de comutadores de traço, consulte Comutadores de Traço.

Ver também

• Switch
• TraceSwitch
• Debug
• Trace