Lire en anglais

Partager via


SourceSwitch Classe

Définition

Fournit un commutateur à plusieurs niveaux pour contrôler la sortie de traçage et de débogage sans recompiler votre code.

public class SourceSwitch : System.Diagnostics.Switch
Héritage
SourceSwitch

Remarques

La Switch propriété de la TraceSource classe est un SourceSwitch objet . La SourceSwitch classe fournit une Level propriété pour tester le niveau d’événement du commutateur. La Level propriété obtient ou définit la valeur du TraceLevel commutateur.

Vous pouvez définir le niveau d’événement d’un SourceSwitch via le fichier de configuration de l’application, puis utiliser le niveau configuré SourceSwitch dans votre application. Vous pouvez également créer un SourceSwitch dans votre code et définir directement le niveau pour instrumenter une section spécifique de code.

Pour configurer un SourceSwitch, modifiez le fichier de configuration qui correspond au nom de votre application. Dans ce fichier, vous pouvez définir la valeur d’un commutateur ou effacer tous les commutateurs précédemment définis par l’application. Le fichier de configuration doit être mis en forme comme indiqué dans l’exemple suivant.

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

Le commutateur est utilisé pour case activée si une trace doit être propagée ou ignorée. Chaque TraceSource méthode de trace appelle la ShouldTrace méthode avant d’appeler les écouteurs. Si la ShouldTrace méthode retourne false, la trace est ignorée et la méthode de trace se ferme. Si la ShouldTrace méthode retourne true, la trace est passée aux écouteurs.

Constructeurs

SourceSwitch(String)

Initialise une nouvelle instance de la classe SourceSwitch et spécifie le nom de la source.

SourceSwitch(String, String)

Initialise une nouvelle instance de la classe SourceSwitch et spécifie le nom complet et la valeur par défaut pour le commutateur source.

Propriétés

Attributes

Obtient les attributs de commutateur personnalisés définis dans le fichier de configuration de l'application.

(Hérité de Switch)
DefaultValue

Obtient la valeur par défaut affectée dans le constructeur.

(Hérité de Switch)
Description

Obtient une description du commutateur.

(Hérité de Switch)
DisplayName

Obtient un nom utilisé pour identifier le commutateur.

(Hérité de Switch)
Level

Obtient ou définit le niveau du commutateur.

SwitchSetting

Obtient ou définit le paramètre en cours pour ce commutateur.

(Hérité de Switch)
Value

Obtient ou définit la valeur du commutateur.

(Hérité de Switch)

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetSupportedAttributes()

Obtient les attributs personnalisés pris en charge par le commutateur.

(Hérité de Switch)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnSwitchSettingChanged()

Appelé lorsque la propriété SwitchSetting a été modifiée.

(Hérité de Switch)
OnValueChanged()

Appelé lorsque la valeur de la propriété Value change.

Refresh()

Actualise les données de configuration de suivi.

(Hérité de Switch)
ShouldTrace(TraceEventType)

Détermine si les écouteurs de la trace doivent être appelés en fonction du type d'événement de trace.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1