Classe BooleanSwitch

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

È possibile abilitare o disabilitare un oggetto BooleanSwitch mediante il file di configurazione dell'applicazione e utilizzare quindi il valore di BooleanSwitch configurato nell'applicazione. In alternativa, creare un oggetto BooleanSwitch nel codice e impostare la proprietà Enabled direttamente per instrumentare una sezione di codice specifica.

Per configurare un oggetto BooleanSwitch, modificare il file di configurazione corrispondente al nome dell'applicazione. All'interno di questo file è possibile aggiungere o rimuovere un'opzione, impostarne il valore o cancellare tutte le opzioni precedentemente impostate 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 oggetto BooleanSwitch con la proprietà DisplayName impostata su mySwitch e la proprietà Enabled impostata su true. Nell'applicazione è possibile utilizzare il valore dell'opzione configurato creando un oggetto BooleanSwitch con lo stesso nome, come illustrato nel seguente esempio di codice:

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)
    {
        //...
    }
}

Per impostazione predefinita, la proprietà Enabled viene impostata utilizzando il valore specificato nel file di configurazione. Configurare l'opzione con il valore 0 per impostare la proprietà Enabled su false. Configurarla con un valore diverso da zero per impostare la proprietà Enabled su true. Se il costruttore di BooleanSwitch non è in grado di trovare un'impostazione iniziale per l'opzione nel file di configurazione, la proprietà Enabled della nuova opzione viene impostata su false per impostazione predefinita.

Per utilizzare un'opzione è necessario attivare la tracciatura o il debug. La sintassi che segue è la sintassi specifica del compilatore. Se si utilizza un compilatore diverso da C# o Visual Basic, fare riferimento alla documentazione specifica del compilatore.

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

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

Nota
Queste opzioni del compilatore per la traccia e il debug non sono necessarie se si utilizza la classe BooleanSwitch in isolamento. Sono necessarie solo con i metodi Trace o Debug compilati in modo condizionale.

Per ulteriori informazioni sugli strumenti a corredo delle applicazioni, vedere Debug e Trace. Per ulteriori informazioni sulla configurazione e l'utilizzo delle opzioni di traccia, vedere Opzioni di traccia.

Nota
Per migliorare le prestazioni, è possibile rendere i membri BooleanSwitchstatic nella classe.

Nell'esempio seguente viene creato un BooleanSwitch, utilizzato per stabilire se generare un messaggio di errore. La creazione dell'opzione avviene a livello di classe. Il metodo Main passa la propria posizione a MyMethod, che genera un messaggio di errore, indicando 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");
 }

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

Riferimenti