BooleanSwitch Classe

Definizione

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

public class BooleanSwitch : System.Diagnostics.Switch

type BooleanSwitch = class
    inherit Switch

Public Class BooleanSwitch
Inherits Switch

Ereditarietà

Object

Switch

BooleanSwitch

Esempio

Nell'esempio seguente viene creato un BooleanSwitch oggetto e viene utilizzata l'opzione per determinare se stampare un messaggio di errore. Si crea l'opzione a livello di classe. Il Main metodo passa la posizione a MyMethod, che stampa un messaggio di errore e dove si è verificato l'errore.

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

Commenti

È possibile usare un'opzione di traccia booleana per abilitare o disabilitare i messaggi in base alla loro importanza. Utilizzare la Enabled proprietà per ottenere il valore corrente dell'opzione.

È possibile creare un oggetto BooleanSwitch nel codice e impostare la Enabled proprietà direttamente per instrumentare una sezione specifica del codice.

Solo per le app .NET Framework, è possibile abilitare o disabilitare un BooleanSwitch tramite il file di configurazione dell'applicazione e quindi usare il valore configurato BooleanSwitch nell'applicazione. Per configurare un BooleanSwitchoggetto , modificare il file di configurazione corrispondente al nome dell'applicazione. All'interno di questo file è possibile aggiungere o rimuovere un'opzione, impostare il valore di un'opzione o cancellare tutte le opzioni impostate in precedenza dall'applicazione. Il file di configurazione deve essere formattato come nell'esempio seguente.

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

Questa sezione di configurazione di esempio definisce un BooleanSwitch oggetto con la DisplayName proprietà impostata su mySwitch e il Enabled valore impostato su true. All'interno dell'applicazione .NET Framework è possibile usare il valore dell'opzione configurato creando un BooleanSwitch oggetto con lo stesso nome, come illustrato nell'esempio di codice seguente.

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

Per le app .NET Core e .NET 5+, la Enabled proprietà del nuovo commutatore è impostata su per false impostazione predefinita.

Per le app .NET Framework, la Enabled proprietà viene impostata usando il valore specificato nel file di configurazione. Configurare l'opzione con un valore pari a 0 per impostare la Enabled proprietà su false. Configurare l'opzione con un valore diverso da zero per impostare la Enabled proprietà su true. Se il BooleanSwitch costruttore non riesce a trovare le impostazioni iniziali del commutatore nel file di configurazione, la Enabled proprietà della nuova opzione è impostata su false.

È necessario abilitare la traccia o il debug per usare un'opzione. La sintassi seguente è specifica del compilatore. Se si usano compilatori diversi da C# o Visual Basic, vedere la documentazione per il compilatore.

• Per abilitare il debug in C#, aggiungere il /d:DEBUG flag alla riga di comando del compilatore durante la compilazione del codice oppure aggiungere #define DEBUG all'inizio del file. In Visual Basic aggiungere il /d:DEBUG=True flag alla riga di comando del compilatore.

• Per abilitare la traccia in C#, aggiungere il /d:TRACE flag alla riga di comando del compilatore quando si compila il codice o aggiungerlo #define TRACE all'inizio del file. In Visual Basic aggiungere il /d:TRACE=True flag alla riga di comando del compilatore.

Per altre informazioni sulla strumentazione dell'applicazione, vedere Debug e Trace. Per altre informazioni sulla configurazione e sull'uso delle opzioni di traccia, vedere Opzioni di traccia.

Vedi anche

• Switch
• TraceSwitch
• Debug
• Trace