Condividi tramite


Procedura: creare e inizializzare opzioni di traccia

Per utilizzare le opzioni di traccia, è necessario prima di tutto crearle e inserirle nel codice. Esistono due classi predefinite da cui è possibile creare oggetti opzione: la classe BooleanSwitch e la classe TraceSwitch. BooleanSwitch viene utilizzata se è necessario stabilire unicamente se i messaggi di tracciatura devono essere visualizzati o meno. TraceSwitch viene invece utilizzata se è necessario distinguere tra i livelli di traccia. Se si utilizza una classe TraceSwitch è possibile definire messaggi di debug personalizzati e associarli a diversi livelli di traccia. È possibile utilizzare entrambi i tipi di opzioni sia per la tracciatura che per il debug. Per impostazione predefinita, BooleanSwitch è disabilitata e TraceSwitch è impostata sul livello TraceLevel.Off. È possibile creare e inserire opzioni di traccia in un punto qualsiasi del codice in cui possano essere utilizzate.

Nonostante sia possibile impostare i livelli di traccia e altre opzioni di configurazione all'interno del codice, si consiglia di utilizzare il file di configurazione per gestire lo stato delle opzioni. Questo perché la gestione della configurazione delle opzioni nel sistema di configurazione consente una maggiore flessibilità: è infatti possibile attivare e disabilitare diverse opzioni e modificare i livelli senza ricompilare l'applicazione. Per ulteriori informazioni, vedere Configurazione delle opzioni di traccia.

Per creare e inizializzare un'opzione di traccia

  1. Definire un'opzione di tipo BooleanSwitch o di tipo TraceSwitch e impostare il nome e la descrizione dell'opzione.

  2. Configurare l'opzione di traccia. Per ulteriori informazioni, vedere Configurazione delle opzioni di traccia.

    Tramite il codice seguente vengono create due opzioni, una per ogni tipo:

    Dim dataSwitch As New BooleanSwitch("Data", "DataAccess module")
    Dim generalSwitch As New TraceSwitch("General", "Entire application")
    
    System.Diagnostics.BooleanSwitch dataSwitch = 
       new System.Diagnostics.BooleanSwitch("Data", "DataAccess module");
    System.Diagnostics.TraceSwitch generalSwitch = 
       new System.Diagnostics.TraceSwitch("General", 
       "Entire application");
    

Vedere anche

Attività

Procedura: configurare opzioni di traccia

Concetti

Opzioni di traccia

Introduzione alla strumentazione e alla traccia