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

Artículo
10/07/2008

Actualización: noviembre 2007

Quita un agente de escucha de la colección Listeners para un origen de seguimiento.

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

<remove name="listenerName" />

Atributos y elementos

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

Atributos

Atributo	Descripción
name	Atributo necesario. Nombre del agente de escucha que se va a quitar de la colección Listeners.

Elementos secundarios

Ninguno.

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.
listeners	Especifica agentes de escucha que recopilan, almacenan y enrutan mensajes.

Comentarios

El elemento <remove> quita un agente de escucha especificado de la colección Listeners para un origen de seguimiento.

Puede quitar mediante programación un elemento de la colección Listeners para un origen de seguimiento llamando al método Remove en la propiedad Listeners de la instancia TraceSource.

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 <remove> antes de usar el elemento <add> para agregar el agente de escucha console a la colección Listeners para el origen de seguimiento TraceSourceApp.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceSourceApp" switchName="sourceSwitch" 
         switchType="System.Diagnostics.SourceSwitch" >
         <listeners>
           <remove name="Default"/>
           <add name="console" 
             type="System.Diagnostics.ConsoleTraceListener" />
         </listeners>
      </source>
    </sources>
  </system.diagnostics>
</configuration>