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.
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à
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) |