<sharedListeners>, élément

Article
05/10/2023

Contient des écouteurs auxquels toute source ou tout élément de trace peuvent faire référence. Ces écouteurs ne reçoivent pas de traces par défaut, et il n’est pas possible de récupérer ces écouteurs au moment de l’exécution. Les écouteurs identifiés en tant qu’écouteurs partagés peuvent être ajoutés à des sources ou des traces par nom.

<configuration>
<system.diagnostics>
<sharedListeners>

Syntaxe

<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

Aucune.

Éléments enfants

Élément	Description
<add>	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 d’écouteurs partagés n’en fait pas un écouteur actif. Il doit quand même être ajouté à une source de trace ou à une trace en l’ajoutant à la collection Listeners pour cet élément de trace. Les classes d’écouteur de .NET Framework dérivent de la classe TraceListener.

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.

Exemple

L’exemple suivant montre comment utiliser l’élément <sharedListeners> avant d’ajouter l’écouteur console à la collection Listeners pour les classes TraceSource et Trace. L’écouteur de trace de console écrit les informations de trace dans la console via des appels à TraceSource ou Trace.

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

Partager via