SourceSwitch Classe

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Source:

SourceSwitch.cs

Viene fornita un'opzione multilivello per il controllo dell'output di tracciatura e debug senza ricompilare il codice.

public ref class SourceSwitch : System::Diagnostics::Switch

public class SourceSwitch : System.Diagnostics.Switch

type SourceSwitch = class
    inherit Switch

Public Class SourceSwitch
Inherits Switch

Ereditarietà

Object

Switch

SourceSwitch

Commenti

La Switch proprietà della TraceSource classe è un SourceSwitch oggetto . La SourceSwitch classe fornisce una Level proprietà per testare il livello di evento dell'opzione. La Level proprietà ottiene o imposta il valore dell'opzione TraceLevel .

È possibile impostare il livello di evento di un SourceSwitch tramite il file di configurazione dell'applicazione e quindi usare il livello configurato SourceSwitch nell'applicazione. In alternativa, è possibile creare un SourceSwitch oggetto nel codice e impostare direttamente il livello per instrumentare una sezione specifica del codice.

Per configurare un SourceSwitchoggetto , modificare il file di configurazione corrispondente al nome dell'applicazione. All'interno di questo file, è possibile impostare il valore di un'opzione o cancellare tutte le opzioni precedentemente impostate dall'applicazione. Il file di configurazione deve essere formattato come illustrato nell'esempio seguente.

<switches>  
  <add name="SourceSwitch" value="Verbose"></add>  
</switches>  

L'opzione viene utilizzata per verificare se una traccia deve essere propagata o ignorata. Ogni TraceSource metodo di traccia chiama il ShouldTrace metodo prima di chiamare i listener. Se il ShouldTrace metodo restituisce false, la traccia viene ignorata e il metodo di traccia viene chiuso. Se il ShouldTrace metodo restituisce true, la traccia viene passata ai listener.

Costruttori

SourceSwitch(String)	Inizializza una nuova istanza della classe SourceSwitch specificando il nome dell'origine.
SourceSwitch(String, String)	Inizializza una nuova istanza della classe SourceSwitch specificando il nome visualizzato e il valore predefinito per l'opzione di origine.

Proprietà

Attributes	Ottiene gli attributi di opzione personalizzati definiti nel file di configurazione dell'applicazione. (Ereditato da Switch)
DefaultValue	Ottiene il valore predefinito assegnato nel costruttore. (Ereditato da Switch)
Description	Ottiene una descrizione dell'opzione. (Ereditato da Switch)
DisplayName	Ottiene un nome utilizzato per identificare l'opzione. (Ereditato da Switch)
Level	Ottiene o imposta il livello dell'opzione.
SwitchSetting	Ottiene o imposta il nome corrente per questa opzione. (Ereditato da Switch)
Value	Ottiene o imposta il valore dell'opzione. (Ereditato da Switch)

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetSupportedAttributes()	Ottiene gli attributi personalizzati supportati dall'opzione. (Ereditato da Switch)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnSwitchSettingChanged()	Viene richiamato quando si modifica la proprietà SwitchSetting. (Ereditato da Switch)
OnValueChanged()	Viene richiamato quando il valore della proprietà Value viene modificato.
Refresh()	Aggiorna i dati configurazione di traccia. (Ereditato da Switch)
ShouldTrace(TraceEventType)	Determina se è possibile chiamare i listener di traccia in base al tipo di evento della traccia.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)