<source>, élément

Article
08/21/2008

Mise à jour : novembre 2007

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

<configuration>, élément
  <system.diagnostics>, élément
    <sources>, élément
      <source>, élément

<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écisé, le type doit représenter 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 à la source de trace, identifié par la méthode GetSupportedAttributes pour cette source de trace.

Éléments enfants

Élément	Description
<listeners>, élément de <trace>	Contient des écouteurs qui collectent, stockent et routent des 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 traçage qui collectent, stockent et routent des messages, ainsi que le niveau auquel un commutateur de traçage est défini.
sources	Contient des sources de trace qui initient des messages de traçage.

Notes

Cet élément peut être utilisé dans le fichier de configuration machine (Machine.config) et dans le fichier de configuration de l'application.

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 la trace console qui écrit les informations de traçage dans la console est ajouté.

<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

Concepts

Sources de trace

Commutateurs de traçage

Référence

Schéma des paramètres de traçage et de débogage

Partager via