Élément <clear> pour <listeners> pour <trace>
Efface la collection Listeners
de la trace.
<configuration>
<system.diagnostics>
<trace>
<listeners>
<clear>
Syntaxe
<clear/>
Attributs et éléments
Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.
Attributs
Aucune.
Éléments enfants
Aucune.
Éléments parents
Élément | Description |
---|---|
configuration |
Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework. |
system.diagnostics |
Spécifie les écouteurs de trace qui collectent, stockent et acheminent les messages, ainsi que le niveau auquel un commutateur de trace est défini. |
trace |
Contient les écouteurs qui collectent, stockent et acheminent les messages de traçage. |
listeners |
Contient les écouteurs qui collectent, stockent et routent les messages. Les écouteurs dirigent la sortie de traçage vers une cible appropriée. |
Notes
L’élément <clear>
supprime tous les écouteurs de la collection Listeners
pour la trace. Vous pouvez utiliser l’élément <clear>
avant d’utiliser l’élément <add>
pour être certain qu’il n’existe aucun autre écouteur actif dans la collection.
Vous pouvez effacer la collection Listeners
par programmation en appelant la méthode Clear au niveau de la propriété Trace.Listeners (System.Diagnostics.Trace.Listeners.Clear()
).
Cet élément peut être utilisé dans le fichier de configuration de l’ordinateur (Machine.config) et dans le fichier de configuration de l’application.
Notes
L’élément <clear>
supprime DefaultTraceListener de la collection Listeners
, modifiant ainsi le comportement des méthodes Debug.Assert, Trace.Assert, Debug.Fail et Trace.Fail. L’appel d’une méthode Assert
ou Fail
fait normalement apparaître une boîte de message. Cependant, la boîte de message ne s’affiche pas si DefaultTraceListener ne se trouve pas dans la collection Listeners
.
Exemple
L’exemple suivant montre comment utiliser l’élément <clear>
avant d’utiliser l’élément <add>
pour ajouter l’écouteur console
à la collection Listeners
pour la trace.
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<clear/>
<add name="console"
type="System.Diagnostics.ConsoleTraceListener" >
<filter type="System.Diagnostics.EventTypeFilter"
initializeData="Error" />
</add>
</listeners>
</trace>
</system.diagnostics>
</configuration>
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour