Elemento <source>

Artículo
05/10/2023

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>

Compartir a través de