BooleanSwitch Klas

Definitie

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

public class BooleanSwitch : System.Diagnostics.Switch

type BooleanSwitch = class
    inherit Switch

Public Class BooleanSwitch
Inherits Switch

Overname

Object

Switch

BooleanSwitch

Voorbeelden

In het volgende voorbeeld wordt een BooleanSwitch en wordt de schakeloptie gebruikt om te bepalen of een foutbericht moet worden afgedrukt. U maakt de schakeloptie op klasniveau. De Main methode geeft de locatie door aan MyMethod, waarmee een foutbericht wordt afgedrukt en waar de fout is opgetreden.

// 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

Opmerkingen

U kunt een Booleaanse traceringsswitch gebruiken om berichten in of uit te schakelen op basis van hun belang. Gebruik de Enabled eigenschap om de huidige waarde van de switch op te halen.

U kunt een BooleanSwitch in uw code maken en de Enabled eigenschap rechtstreeks instellen om een specifiek codegedeelte te instrumenteren.

Voor .NET Framework-apps kunt u ook een BooleanSwitch in- of uitschakelen via het toepassingsconfiguratiebestand en vervolgens de geconfigureerde BooleanSwitch-waarde in uw toepassing gebruiken. Als u een BooleanSwitchconfiguratiebestand wilt configureren, bewerkt u het configuratiebestand dat overeenkomt met de naam van uw toepassing. In dit bestand kunt u een switch toevoegen of verwijderen, de waarde van een switch instellen of alle schakelopties wissen die eerder door de toepassing zijn ingesteld. Het configuratiebestand moet worden opgemaakt zoals in het volgende voorbeeld.

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

In dit voorbeeld van de configuratiesectie wordt een BooleanSwitch met de DisplayName eigenschap gedefinieerd waarop mySwitch en de Enabled waarde is ingesteld op true. In uw .NET Framework-toepassing kunt u de geconfigureerde switchwaarde gebruiken door een BooleanSwitch met dezelfde naam te maken, zoals wordt weergegeven in het volgende codevoorbeeld.

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

Voor .NET Core- en .NET 5+-apps is de eigenschap Enabled van de nieuwe switch standaard ingesteld op false.

Voor .NET Framework-apps wordt de eigenschap Enabled ingesteld met behulp van de waarde die is opgegeven in het configuratiebestand. Configureer de schakeloptie met de waarde 0 om de Enabled eigenschap falsein te stellen op ; configureer de switch met een niet-nulwaarde om de Enabled eigenschap truein te stellen op . Als de constructor de BooleanSwitch eerste switchinstellingen in het configuratiebestand niet kan vinden, wordt de Enabled eigenschap van de nieuwe switch ingesteld op false.

U moet tracering of foutopsporing inschakelen om een switch te kunnen gebruiken. De volgende syntaxis is specifiek voor compileren. Als u andere compilers dan C# of Visual Basic gebruikt, raadpleegt u de documentatie voor uw compiler.

• Als u foutopsporing in C# wilt inschakelen, voegt u de /d:DEBUG vlag toe aan de opdrachtregel van de compiler wanneer u uw code compileert of kunt u toevoegen #define DEBUG aan het begin van het bestand. Voeg in Visual Basic de vlag /d:DEBUG=True toe aan de opdrachtregel van de compiler.

• Als u tracering in C# wilt inschakelen, voegt u de /d:TRACE vlag toe aan de opdrachtregel van de compiler wanneer u uw code compileert of voegt u deze toe #define TRACE aan het begin van het bestand. Voeg in Visual Basic de vlag /d:TRACE=True toe aan de opdrachtregel van de compiler.

Zie en Tracevoor meer informatie over het instrumenteren van uw toepassingDebug. Zie Trace Switches voor meer informatie over het configureren en gebruiken van traceringsswitches.

Zie ook

• Switch
• TraceSwitch
• Debug
• Trace