Partager via

<source> Élément

Spécifie une source de trace qui lance le suivi des messages.

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

Attributes

Caractéristique Descriptif
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 <switches> élément, 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 à la source de trace identifié par la GetSupportedAttributes méthode de cette source de trace.

Éléments enfants

Élément Descriptif
<Auditeurs> Contient des écouteurs qui collectent, stockent et routent des messages.

É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 les écouteurs de suivi qui collectent, stockent et routent les messages et le niveau où un commutateur de trace est défini.
sources Contient des sources de trace qui lancent le suivi des messages.

Remarques

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 <source> pour ajouter la source mySource de trace et définir le niveau du commutateur source nommé sourceSwitch. Un écouteur de trace de console est ajouté qui écrit des 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

  • Last updated on