Partage via


<sharedListeners> Élément

Contient des écouteurs que n’importe quel élément source ou trace peut référencer. 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 comme é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.

Attributes

Aucun.

Éléments enfants

Élément Descriptif
<ajouter> Ajoute un écouteur à la sharedListeners collection.

Éléments parents

Élément Descriptif
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.

Remarques

L’ajout d’un écouteur à la collection d’écouteurs partagés ne le rend pas un écouteur actif. Elle doit toujours être ajoutée à une source de trace ou à une trace en l’ajoutant à la Listeners collection pour cet élément de trace. Les classes d’écouteur dans le .NET Framework dérivent de la TraceListener classe.

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.

Example

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

<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>

Voir aussi