SourceSwitch SourceSwitch SourceSwitch SourceSwitch Class

Definizione

Viene fornita un'opzione multilivello per il controllo dell'output di tracciatura e debug senza ricompilare il codice.Provides a multilevel switch to control tracing and debug output without recompiling your code.

public ref class SourceSwitch : System::Diagnostics::Switch
public class SourceSwitch : System.Diagnostics.Switch
type SourceSwitch = class
    inherit Switch
Public Class SourceSwitch
Inherits Switch
Ereditarietà
SourceSwitchSourceSwitchSourceSwitchSourceSwitch

Commenti

Il Switch proprietà del TraceSource classe è un SourceSwitch oggetto.The Switch property of the TraceSource class is a SourceSwitch object. Il SourceSwitch classe fornisce un Level proprietà per verificare il livello evento dell'interruttore.The SourceSwitch class provides a Level property to test the event level of the switch. Il Level proprietà ottiene o imposta l'opzione TraceLevel valore.The Level property gets or sets the switch's TraceLevel value.

È possibile impostare l'evento a livello di un SourceSwitch tramite il file di configurazione dell'applicazione e utilizzare quindi l'applicazione configurata SourceSwitch a livello dell'applicazione.You can set the event level of a SourceSwitch through the application configuration file and then use the configured SourceSwitch level in your application. In alternativa, è possibile creare un SourceSwitch nel codice e impostare direttamente il livello di instrumentare una particolare sezione di codice.Alternatively, you can create a SourceSwitch in your code and set the level directly, to instrument a specific section of code.

Per configurare un SourceSwitch, modificare il file di configurazione che corrisponde al nome dell'applicazione.To configure a SourceSwitch, edit the configuration file that corresponds to the name of your application. All'interno di questo file, è possibile impostare il valore dell'opzione o deselezionare tutte le opzioni impostate in precedenza dall'applicazione.Within this file, you can set a switch's value or clear all the switches previously set by the application. Il file di configurazione deve essere formattato come illustrato nell'esempio seguente.The configuration file should be formatted as shown in the following example.

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

L'opzione viene utilizzata per verificare se una traccia debba essere propagata o ignorata.The switch is used to check whether a trace should be propagated or ignored. Ciascuna TraceSource tracciare le chiamate di metodo di ShouldTrace metodo prima di chiamare i listener.Each TraceSource trace method calls the ShouldTrace method before calling the listeners. Se il ShouldTrace restituzione del metodo false, la traccia viene ignorata e il metodo di traccia viene chiuso.If the ShouldTrace method returns false, the trace is ignored and the trace method exits. Se il ShouldTrace restituzione del metodo true, la traccia viene passata al listener.If the ShouldTrace method returns true, the trace is passed to the listeners.

Costruttori

SourceSwitch(String) SourceSwitch(String) SourceSwitch(String) SourceSwitch(String)

Inizializza una nuova istanza della classe SourceSwitch specificando il nome dell'origine.Initializes a new instance of the SourceSwitch class, specifying the name of the source.

SourceSwitch(String, String) SourceSwitch(String, String) SourceSwitch(String, String) SourceSwitch(String, String)

Inizializza una nuova istanza della classe SourceSwitch specificando il nome visualizzato e il valore predefinito per l'opzione di origine.Initializes a new instance of the SourceSwitch class, specifying the display name and the default value for the source switch.

Proprietà

Attributes Attributes Attributes Attributes

Ottiene gli attributi di opzione personalizzati definiti nel file di configurazione dell'applicazione.Gets the custom switch attributes defined in the application configuration file.

(Inherited from Switch)
Description Description Description Description

Ottiene una descrizione dell'opzione.Gets a description of the switch.

(Inherited from Switch)
DisplayName DisplayName DisplayName DisplayName

Ottiene un nome utilizzato per identificare l'opzione.Gets a name used to identify the switch.

(Inherited from Switch)
Level Level Level Level

Ottiene o imposta il livello dell'opzione.Gets or sets the level of the switch.

SwitchSetting SwitchSetting SwitchSetting SwitchSetting

Ottiene o imposta il nome corrente per questa opzione.Gets or sets the current setting for this switch.

(Inherited from Switch)
Value Value Value Value

Ottiene o imposta il valore dell'opzione.Gets or sets the value of the switch.

(Inherited from Switch)

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetSupportedAttributes() GetSupportedAttributes() GetSupportedAttributes() GetSupportedAttributes()

Ottiene gli attributi personalizzati supportati dall'opzione.Gets the custom attributes supported by the switch.

(Inherited from Switch)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
OnSwitchSettingChanged() OnSwitchSettingChanged() OnSwitchSettingChanged() OnSwitchSettingChanged()

Viene richiamato quando si modifica la proprietà SwitchSetting.Invoked when the SwitchSetting property is changed.

(Inherited from Switch)
OnValueChanged() OnValueChanged() OnValueChanged() OnValueChanged()

Viene richiamato quando il valore della proprietà Value viene modificato.Invoked when the value of the Value property changes.

ShouldTrace(TraceEventType) ShouldTrace(TraceEventType) ShouldTrace(TraceEventType) ShouldTrace(TraceEventType)

Determina se è possibile chiamare i listener di traccia in base al tipo di evento della traccia.Determines if trace listeners should be called, based on the trace event type.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Si applica a