SourceSwitch Classe

Définition

Espace de noms:

System.Diagnostics

Assemblys:

netstandard.dll, System.Diagnostics.TraceSource.dll

Source:

SourceSwitch.cs

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

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

public class SourceSwitch : System.Diagnostics.Switch

type SourceSwitch = class
    inherit Switch

Public Class SourceSwitch
Inherits Switch

Héritage

Object

Switch

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 code dans votre code et définir le niveau directement pour instrumenter une section spécifique du code.

Pour configurer un SourceSwitchfichier de configuration, 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 vérifier 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 transmise aux écouteurs.

Constructeurs

Nom	Description
SourceSwitch(String, String)	Initialise une nouvelle instance de la SourceSwitch classe, en spécifiant le nom complet et la valeur par défaut du commutateur source.
SourceSwitch(String)	Initialise une nouvelle instance de la SourceSwitch classe, en spécifiant le nom de la source.

Propriétés

Nom	Description
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 actuel pour ce commutateur. (Hérité de Switch)
Value	Obtient ou définit la valeur du commutateur. (Hérité de Switch)

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert 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 la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnSwitchSettingChanged()	Appelé lorsque la SwitchSetting propriété est modifiée. (Hérité de Switch)
OnValueChanged()	Appelé lorsque la valeur de la Value propriété change.
Refresh()	Actualise les données de configuration de trace. (Hérité de Switch)
ShouldTrace(TraceEventType)	Détermine si les écouteurs de suivi 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)