Compartir a través de


<source> (Elemento)

Actualización: noviembre 2007

Especifica un origen de seguimiento que inicia mensajes de seguimiento.

<configuration> (Elemento)
  Elemento <system.diagnostics>
    <sources> (Elemento)
      <source> (Elemento)

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

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y 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 para un seguimiento que el atributo específico del origen identificado por el método GetSupportedAttributes de ese origen de seguimiento.

Elementos secundarios

Elemento

Descripción

Elemento <listeners> para <trace>

Contiene agentes de escucha que recopilan, almacenan y enrutan mensajes.

Elementos primarios

Elemento

Descripción

configuration

Es el elemento raíz de cada archivo de configuración que utilizan las aplicaciones Common Language Runtime y .NET Framework.

system.diagnostics

Especifica los agentes de escucha de seguimiento que recopilan, almacenan y enrutan mensajes, y el nivel donde se establece un modificador de seguimiento.

sources

Contiene orígenes de seguimiento que inician mensajes de seguimiento.

Comentarios

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

Ejemplo

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

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

Vea también

Conceptos

Orígenes de seguimiento

Modificadores de seguimiento

Referencia

Esquema de la configuración de seguimiento y depuración