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 oggetto BooleanSwitch e viene usato l'opzione per determinare se stampare un messaggio di errore. Si crea l'opzione a livello di classe. Il Main metodo passa il percorso a MyMethod, che stampa un messaggio di errore e dove si è verificato l'errore.

public ref class BooleanSwitchTest
{
private:

   /* Create a BooleanSwitch for data.*/
   static BooleanSwitch^ dataSwitch = gcnew BooleanSwitch( "Data","DataAccess module" );

public:
   static void MyMethod( String^ location )
   {
      
      //Insert code here to handle processing.
      if ( dataSwitch->Enabled )
            Console::WriteLine( "Error happened at {0}", location );
   }

};

int main()
{
   
   //Run the method which writes an error message specifying the location of the error.
   BooleanSwitchTest::MyMethod( "in main" );
}

// 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 commutatore di traccia booleano 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 BooleanSwitch oggetto 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 commutatore o cancellare tutte le opzioni impostate in precedenza dall'applicazione. Il file di configurazione deve essere formattato come l'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 del commutatore configurato creando un BooleanSwitch oggetto con lo stesso nome, come illustrato nell'esempio di codice seguente.

private:
    static BooleanSwitch^ boolSwitch = gcnew BooleanSwitch("mySwitch",
        "Switch in config file");

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

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 false per 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à del nuovo commutatore è impostata su false.

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

• Per abilitare il debug in C#, aggiungere il flag alla riga di comando del compilatore quando si compila il /d:DEBUG codice oppure aggiungere #define DEBUG alla parte superiore 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 flag alla riga di comando del compilatore quando si compila il /d:TRACE codice o aggiungere #define TRACE alla parte superiore 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 di commutatori di traccia, vedere Commutatori di traccia.

Costruttori

Proprietà

Metodi

Si applica a

Vedi anche

• Switch
• TraceSwitch
• Debug
• Trace