<source> (Elemento)

Artículo
08/10/2011

Especifica un origen de traza que inicia mensajes de traza.

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

Atributos y elementos

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

Atributos

Atributo	Descripción
name	Atributo opcional. Especifica el nombre del origen de traza.
switchName	Atributo opcional. Especifica el nombre de una instancia de modificador de traza 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 traza. 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 una traza que el atributo específico del origen identificado por el método GetSupportedAttributes de ese origen de traza.

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	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 traza que recopilan, almacenan y enrutan mensajes, y el nivel donde se establece un modificador de traza.
sources	Contiene orígenes de traza que inician mensajes de traza.

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 traza mySource y establecer el nivel del modificador de origen denominado sourceSwitch. Se agrega un agente de escucha de traza de la consola que escribe información de traza 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

Referencia

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

Conceptos

Trace Sources

Modificadores de seguimiento

Share via