Partager via


<source>, élément

Spécifie une source de trace qui lance des messages de traçage.

<configuration>
  <system.diagnostics>
    <sources>
      <source>

Syntaxe

<source>
  <listeners>...</listeners>  
</source>  

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

Spécifie le nom de la source de trace.
switchName Attribut facultatif.

Spécifie le nom d’une instance de commutateur de trace dans l’application. Si le commutateur n’est pas identifié dans un élément <switches>, la valeur spécifie le niveau du commutateur.
switchType Attribut facultatif.

Spécifie le type du commutateur de trace. S’il est présent, le type doit être un nom de classe valide et ne peut pas être une chaîne vide.
extraAttribute Attribut facultatif.

Spécifie la valeur d’un attribut spécifique de la source de trace identifié par la méthode GetSupportedAttributes pour cette source de trace.

Éléments enfants

Élément Description
<listeners> Contient les écouteurs qui collectent, stockent et routent les messages.

É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.
sources Contient les sources de trace qui lancent des messages de traçage.

Notes

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 l’élément <source> pour ajouter la source de trace mySource et définir le niveau du commutateur source nommé sourceSwitch. Un écouteur de trace de console est ajouté pour écrire les informations de trace dans la console.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="mySource" switchName="sourceSwitch" switchType="System.Diagnostics.SourceSwitch"  >  
        <listeners>  
          <add name="console" type="System.Diagnostics.ConsoleTraceListener" >  
            <filter type="System.Diagnostics.EventTypeFilter" initializeData="Error" />  
          </add>  
          <remove name="Default" />  
        </listeners>  
      </source>  
    </sources>  
        <switches>  
           <add name="sourceSwitch" value="Warning" />  
        </switches>
  </system.diagnostics>
</configuration>  

Voir aussi