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 a seguir cria um BooleanSwitch e usa a opção para determinar se uma mensagem de erro deve ser impressa. Você cria a opção no nível da classe. O Main método passa seu local para MyMethod, o que imprime uma mensagem de erro e 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

Comentários

Você pode usar um comutador de rastreamento booliano para habilitar ou desabilitar mensagens com base em sua importância. Use a Enabled propriedade para obter o valor atual da opção.

Você pode criar um BooleanSwitch no código e definir a Enabled propriedade diretamente para instrumentar uma seção específica do código.

Somente para aplicativos do .NET Framework, você também pode habilitar ou desabilitar um BooleanSwitch por meio do arquivo de configuração do aplicativo e, em seguida, usar o valor configurado BooleanSwitch em seu aplicativo. Para configurar um BooleanSwitcharquivo de configuração, edite o arquivo de configuração que corresponde ao nome do aplicativo. Nesse arquivo, você pode adicionar ou remover um comutador, definir o valor de um comutador ou limpar todas as opções definidas anteriormente pelo aplicativo. O arquivo de configuração deve ser formatado como o exemplo a seguir.

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="1"/>
    </switches>
  </system.diagnostics>
</configuration>

Esta seção de configuração de exemplo define um BooleanSwitch com a DisplayName propriedade definida mySwitch como e o Enabled valor definido como true. No aplicativo .NET Framework, você pode usar o valor de comutador configurado criando um BooleanSwitch com o mesmo nome, conforme mostrado no exemplo de código a seguir.

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 aplicativos .NET Core e .NET 5+, a Enabled propriedade do novo comutador é definida false como por padrão.

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

Você deve habilitar o rastreamento ou a depuração para usar uma opção. A sintaxe a seguir é específica do compilador. Se você usar compiladores diferentes de C# ou Visual Basic, consulte a documentação do compilador.

• Para habilitar a depuração em C#, adicione o /d:DEBUG sinalizador à linha de comando do compilador ao compilar seu código ou adicione #define DEBUG à parte superior do arquivo. No Visual Basic, adicione o /d:DEBUG=True sinalizador à linha de comando do compilador.

• Para habilitar o rastreamento em C#, adicione o /d:TRACE sinalizador à linha de comando do compilador ao compilar seu código ou adicione #define TRACE à parte superior do arquivo. No Visual Basic, adicione o /d:TRACE=True sinalizador à linha de comando do compilador.

Para obter mais informações sobre como instrumentar seu aplicativo, consulte Debug e Trace. Para obter mais informações sobre como configurar e usar comutadores de rastreamento, consulte Os Comutadores de Rastreamento.

Confira também

• Switch
• TraceSwitch
• Debug
• Trace