SourceSwitch Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce un commutatore a più livelli per controllare la traccia e il debug dell'output senza ricompilare il codice.
public ref class SourceSwitch : System::Diagnostics::Switchpublic class SourceSwitch : System.Diagnostics.Switchtype SourceSwitch = class
inherit SwitchPublic Class SourceSwitch
Inherits Switch- Ereditarietà
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 oggetto SourceSwitch 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 impostate in precedenza 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 usata 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
| Nome | Descrizione |
|---|---|
| SourceSwitch(String, String) |
Inizializza una nuova istanza della SourceSwitch classe , specificando il nome visualizzato e il valore predefinito per l'opzione di origine. |
| SourceSwitch(String) |
Inizializza una nuova istanza della SourceSwitch classe , specificando il nome dell'origine. |
Proprietà
| Nome | Descrizione |
|---|---|
| Attributes |
Ottiene gli attributi del commutatore personalizzato 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 l'impostazione corrente per questa opzione. (Ereditato da Switch) |
| Value |
Ottiene o imposta il valore dell'opzione. (Ereditato da Switch) |
Metodi
| Nome | Descrizione |
|---|---|
| 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 il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnSwitchSettingChanged() |
Richiamato quando la SwitchSetting proprietà viene modificata. (Ereditato da Switch) |
| OnValueChanged() |
Richiamato quando viene modificato il valore della Value proprietà. |
| Refresh() |
Aggiorna i dati di configurazione della traccia. (Ereditato da Switch) |
| ShouldTrace(TraceEventType) |
Determina se i listener di traccia devono essere chiamati, in base al tipo di evento di traccia. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
