Partager via

Élément <add> pour <sharedListeners>

  • Article

Ajoute un écouteur à la collection sharedListeners. sharedListeners est une collection d’écouteurs auxquels toute <source> ou toute <trace> peuvent faire référence. Par défaut, les écouteurs de la collection sharedListeners ne sont pas placés dans une collection Listeners. Ils doivent être ajoutés par nom à la source< ou à la >trace<>. Il n’est pas possible d’obtenir les écouteurs de la collection sharedListeners dans le code au moment de l’exécution.

<configuration>
  <system.diagnostics>
    <sharedListeners>
      <add>

Syntaxe

<add name="name"
  type="TraceListenerClassName, Version, Culture, PublicKeyToken"  
  initializeData="data"
  traceOutputOptions = "None"
/>

Attributs et éléments

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

Attributs

Attribut Description
name Attribut requis.

Spécifie le nom de l’écouteur utilisé pour ajouter l’écouteur partagé à une collection Listeners.
type Attribut requis.

Spécifie le type de l’écouteur. Vous pouvez utiliser une chaîne qui répond aux exigences spécifiées dans Spécification des noms de types complets.
initializeData Attribut facultatif.

Chaîne transmise au constructeur pour la classe spécifiée.
traceOutputOptions Attribut facultatif.

Représentation sous forme de chaîne d’un ou de plusieurs membres d’énumération TraceOptions qui indique les données à écrire dans la sortie de la trace. Les éléments sont séparés par des virgules s’il y en a plusieurs. La valeur par défaut est « None ».

Éléments enfants

Élément Description
<filter> Ajoute un filtre à un écouteur dans 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 les écouteurs de trace qui collectent, stockent et acheminent les messages, ainsi que le niveau auquel un commutateur de trace est défini.
sharedListeners Collection d’écouteurs auxquels toute source ou tout élément de trace peuvent faire référence.

Notes

Les classes d’écouteur fournies avec .NET Framework dérivent de la classe TraceListener. La valeur de l’attribut name est utilisée pour ajouter l’écouteur partagé à une collection Listeners pour une trace ou une source de trace. La valeur de l’attribut initializeData dépend du type d’écouteur que vous créez. Pour certains écouteurs de trace, il n’est pas nécessaire de spécifier initializeData.

Notes

Quand vous utilisez l’attribut initializeData, il se peut que obteniez un avertissement du compilateur indiquant que l’attribut « InitializeData » n’est pas déclaré. Cet avertissement apparaît, car les paramètres de configuration sont validés par rapport à la classe de base abstraite TraceListener, qui ne reconnaît pas l’attribut initializeData. En règle générale, vous pouvez ignorer cet avertissement pour les implémentations d’écouteur de trace doté d’un constructeur qui accepte un paramètre.

Le tableau suivant présente les écouteurs de trace qui accompagnent .NET Framework et décrit la valeur de leurs attributs initializeData.

Classe d’écouteur de trace Valeur d’attribut initializeData
ConsoleTraceListener Valeur useErrorStream du constructeur ConsoleTraceListener. Définissez l’attribut initializeData sur « true » pour écrire la sortie de trace et de débogage dans le flux d’erreur standard ; définissez-le sur « false » pour écrire dans le flux de sortie standard.
DelimitedListTraceListener Nom du fichier vers lequel DelimitedListTraceListener écrit.
System.Diagnostics.EventLogTraceListener Nom d'une source existante de journal des événements.
System.Diagnostics.EventSchemaTraceListener Nom du fichier dans lequel EventSchemaTraceListener écrit.
System.Diagnostics.TextWriterTraceListener Nom du fichier dans lequel TextWriterTraceListener écrit.
XmlWriterTraceListener Nom du fichier dans lequel XmlWriterTraceListener écrit.

Fichier de configuration

Cet élément peut être défini dans le fichier de configuration de l’application ou dans le fichier de configuration de l’ordinateur (Machine.config).

Exemple

L’exemple suivant montre comment utiliser les éléments <add> pour ajouter TextWriterTraceListenertextListener à la collection sharedListeners. textListener est ajouté par nom à la collection Listeners pour la source de trace TraceSourceApp. L’écouteur textListener écrit la sortie de trace dans le fichier myListener.log.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="TraceSourceApp" switchName="sourceSwitch"
        switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener"/>  
          <add name="textListener"/>  
          <remove name="Default"/>  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add name="textListener"
        type="System.Diagnostics.TextWriterTraceListener"
        initializeData="myListener.log"/>  
    </sharedListeners>  
    <switches>  
      <add name="sourceSwitch" value="Warning"/>  
    </switches>  
  </system.diagnostics>  
</configuration>

Voir aussi