<sharedListeners>, élément

Article
08/21/2008

Mise à jour : novembre 2007

Contient des écouteurs qui peuvent être référencés par n'importe quel élément trace ou source. Ces écouteurs ne reçoivent pas de traces par défaut et il n'est pas possible de les récupérer au moment de l'exécution. Les écouteurs identifiés comme des écouteurs partagés peuvent être ajoutés aux sources ou aux traces par nom.

<configuration>, élément
<system.diagnostics>, élément
<sharedListeners>, élément

<sharedListeners> 
  <add>...</add>
</sharedListeners>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Aucun.

Éléments enfants

Élément	Description
<add>, élément de <listeners> pour <trace>	Ajoute un écouteur à la collection sharedListeners.

É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 l'élément racine de la section de configuration ASP.NET.

Notes

L'ajout d'un écouteur à la collection sharedListeners ne l'active pas pour autant. Il doit encore être ajouté à une source de trace ou à une trace en l'ajoutant à la collection Listeners de cet élément trace. Les classes d'écouteur du .NET Framework dérivent de la classe TraceListener.

Cet élément peut être utilisé dans le fichier de configuration machine (Machine.config) et dans le fichier de configuration de l'application.

Exemple

L'exemple suivant montre comment utiliser l'élément <sharedListeners> pour ajouter l'écouteur console à la collection Listeners pour les classes TraceSource et Trace. L'écouteur de la trace console écrit des informations de traçage dans la console par des appels à TraceSource ou à Trace.

<system.diagnostics>
  <sources>
    <source name="mySource" switchName="sourceSwitch value="Verbose" >
      <listeners>
        <add name="console" />
      </listeners>
    </source>
  </sources>  
  <sharedListeners>    <add name="console" type="System.Diagnostics.ConsoleTraceListener" >      <filter type="System.Diagnostics.EventTypeFilter"         initializeData="Warning" />    </add>  </sharedListeners>
  <trace>
    <listeners>
      <add name="console" />
    </listeners>
  </trace>
</system.diagnostics>

Voir aussi

Concepts

Écouteurs de la trace

Référence

Schéma des paramètres de traçage et de débogage

TraceListener

Partager via