Elemento <source>

  • Artículo

Contiene un origen de seguimiento que inicia mensajes de seguimiento.

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

Sintaxis

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

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo Descripción
name Atributo opcional.

Especifica el nombre del origen de seguimiento.
switchName Atributo opcional.

Especifica el nombre de una instancia de modificador de seguimiento en la aplicación. Si el modificador no se identifica en un elemento <switches>, el valor especifica el nivel del modificador.
switchType Atributo opcional.

Especifica el tipo del modificador de seguimiento. Si está presente, el tipo debe ser un nombre de clase válido y no puede ser una cadena vacía.
extraAttribute Atributo opcional.

Especifica el valor de un atributo de seguimiento específico del origen identificado por el método GetSupportedAttributes para ese origen de seguimiento.

Elementos secundarios

Elemento Descripción
<listeners> Contiene clientes de escucha que recopilan, almacenan y enrutan los mensajes.

Elementos primarios

Elemento Descripción
configuration Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.
system.diagnostics Especifica los agentes de escucha de seguimiento que recopilan, almacenan y enrutan mensajes, así como el nivel en el que está establecido un modificador de seguimiento.
sources Contiene orígenes de seguimiento que inician mensajes de seguimiento.

Comentarios

Este elemento se puede usar en el archivo de configuración del equipo (Machine.config) o en el archivo de configuración de la aplicación.

Ejemplo

En el ejemplo siguiente se muestra cómo usar el elemento <source> para agregar el origen de seguimiento mySource y para establecer el nivel del modificador de origen denominado sourceSwitch. Se agrega un cliente de escucha de seguimiento de la consola que escribe información de seguimiento en esta.

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

Consulte también