BooleanSwitch Classe

Définition

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

public class BooleanSwitch : System.Diagnostics.Switch

type BooleanSwitch = class
    inherit Switch

Public Class BooleanSwitch
Inherits Switch

Héritage

Object

Switch

BooleanSwitch

Exemples

L’exemple suivant crée un BooleanSwitch commutateur et utilise le commutateur pour déterminer s’il faut imprimer un message d’erreur. Vous créez le commutateur au niveau de la classe. La Main méthode transmet son emplacement à MyMethod, qui imprime un message d’erreur et où l’erreur s’est produite.

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

Remarques

Vous pouvez utiliser un commutateur de trace booléen pour activer ou désactiver des messages en fonction de leur importance. Utilisez la Enabled propriété pour obtenir la valeur actuelle du commutateur.

Vous pouvez créer un BooleanSwitch code dans votre code et définir la Enabled propriété directement pour instrumenter une section spécifique du code.

Pour les applications .NET Framework uniquement, vous pouvez également activer ou désactiver un BooleanSwitch via le fichier de configuration de l’application, puis utiliser la valeur configurée BooleanSwitch dans votre application. Pour configurer un BooleanSwitchfichier de configuration, modifiez le fichier de configuration qui correspond au nom de votre application. Dans ce fichier, vous pouvez ajouter ou supprimer un commutateur, définir la valeur d’un commutateur ou effacer tous les commutateurs précédemment définis par l’application. Le fichier de configuration doit être mis en forme comme l’exemple suivant.

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

Cet exemple de section de configuration définit une BooleanSwitch propriété définie sur mySwitch et la Enabled valeur définie sur trueDisplayName . Dans votre application .NET Framework, vous pouvez utiliser la valeur de commutateur configurée en créant un BooleanSwitch nom portant le même nom, comme indiqué dans l’exemple de code suivant.

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

Pour les applications .NET Core et .NET 5+, la Enabled propriété du nouveau commutateur est définie false par défaut.

Pour les applications .NET Framework, la Enabled propriété est définie à l’aide de la valeur spécifiée dans le fichier de configuration. Configurez le commutateur avec la valeur 0 pour définir la Enabled propriété falsesur ; configurez le commutateur avec une valeur différente de zéro pour définir la Enabled propriété truesur . Si le constructeur ne trouve pas les BooleanSwitch paramètres de commutateur initial dans le fichier de configuration, la Enabled propriété du nouveau commutateur est définie sur false.

Vous devez activer le suivi ou le débogage pour utiliser un commutateur. La syntaxe suivante est spécifique au compilateur. Si vous utilisez des compilateurs autres que C# ou Visual Basic, reportez-vous à la documentation de votre compilateur.

• Pour activer le débogage en C#, ajoutez l’indicateur /d:DEBUG à la ligne de commande du compilateur lorsque vous compilez votre code, ou vous pouvez ajouter #define DEBUG en haut de votre fichier. Dans Visual Basic, ajoutez l’indicateur /d:DEBUG=True à la ligne de commande du compilateur.

• Pour activer le suivi en C#, ajoutez l’indicateur /d:TRACE à la ligne de commande du compilateur lorsque vous compilez votre code ou ajoutez-y #define TRACE en haut de votre fichier. Dans Visual Basic, ajoutez l’indicateur /d:TRACE=True à la ligne de commande du compilateur.

Pour plus d’informations sur l’instrumentation de votre application, consultez Debug et Trace. Pour plus d’informations sur la configuration et l’utilisation des commutateurs de trace, consultez Commutateurs de trace.

Voir aussi

• Switch
• TraceSwitch
• Debug
• Trace