Compartir a través de


Elemento <listeners> de <source>

Actualización: noviembre 2007

Agrega o quita los agentes de escucha de la colección Listeners para un origen TraceSource. Los agentes de escucha dirigen los resultados del seguimiento a un destino apropiado, como un registro, una ventana o un archivo de texto.

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

<listeners> 
  <add>...</add>
  <remove ... />
  <clear/>
</listeners>

Atributos y elementos

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

Atributos

Ninguno.

Elementos secundarios

Elemento

Descripción

Elemento <add> de <listeners> de <source>

Agrega un agente de escucha a la colección Listeners.

Elemento <remove> de <listeners> de <source>

Quita un agente de escucha de la colección Listeners.

Elemento <clear> de <listeners> de <source>

Borra la colección Listeners para un origen de seguimiento.

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.

source

Especifica un origen de seguimiento que inicia mensajes de seguimiento.

Comentarios

Archivo de configuración

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 <listeners> para agregar un agente de escucha de seguimiento de consola al origen mySource y para quitar el agente de escucha de seguimiento predeterminado.

<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

Agentes de escucha de seguimiento

Referencia

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

TraceListener