<source> Élément<source> Element

Spécifie une source de trace qui lance des messages de traçage.Specifies a trace source that initiates tracing messages.

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

SyntaxeSyntax

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

Attributs et élémentsAttributes and Elements

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
name Attribut facultatif.Optional attribute.

Spécifie le nom de la source de traces.Specifies the name of the trace source.
switchName Attribut facultatif.Optional attribute.

Spécifie le nom d’une instance de commutateur de trace dans l’application.Specifies the name of a trace switch instance in the application. Si le commutateur n’est pas identifié dans un <switches> élément, la valeur spécifie le niveau de l’interrupteur.If the switch is not identified in a <switches> element, the value specifies the level for the switch.
switchType Attribut facultatif.Optional attribute.

Spécifie le type de commutateur de traces.Specifies the type of the trace switch. Si c’est présent, le type doit être un nom de classe valide et ne peut pas être une chaîne vide.If present, the type must be a valid class name and cannot be an empty string.
extraAttribute Attribut facultatif.Optional attribute.

Spécifie la valeur d’un attribut GetSupportedAttributes spécifique à la source de traces identifié par la méthode pour cette source de traces.Specifies the value for a trace source-specific attribute identified by the GetSupportedAttributes method for that trace source.

Éléments enfantsChild Elements

ÉlémentElement DescriptionDescription
<auditeurs><listeners> Contient des auditeurs qui recueillent, stockent et acheminent des messages.Contains listeners that collect, store, and route messages.

Éléments parentsParent Elements

ÉlémentElement DescriptionDescription
configuration Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
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.Specifies trace listeners that collect, store, and route messages and the level where a trace switch is set.
sources Contient les sources de trace qui lancent des messages de traçage.Contains trace sources that initiate tracing messages.

Notes Remarks

Cet élément peut être utilisé dans le fichier de configuration de la machine (Machine.config) et le fichier de configuration d’application.This element can be used in the machine configuration file (Machine.config) and the application configuration file.

 ExempleExample

L’exemple suivant montre <source> comment utiliser l’élément pour ajouter la source mySource sourceSwitchde trace et pour définir le niveau pour le commutateur source nommé .The following example shows how to use the <source> element to add the trace source mySource and to set the level for the source switch named sourceSwitch. Un auditeur de trace de console est ajouté qui écrit des informations de trace à la console.A console trace listener is added that writes trace information to the 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 aussiSee also