<source>, élément

Article
05/10/2023

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>