Elemento <clear> de <listeners> de <trace>

Artículo
12/12/2008

Actualización: noviembre 2007

Borra la colección Listeners para seguimiento.

<configuration> (Elemento)
  Elemento <system.diagnostics>
    Elemento <trace>
      Elemento <listeners> para <trace>
        Elemento <clear> de <listeners> de <trace>

<clear/>

Atributos y elementos

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

Atributos

Ninguna.

Elementos secundarios

Ninguna.

Elementos primarios

Elemento	Descripción
configuration	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.
trace	Contiene agentes de escucha que recopilan, almacenan y enrutan mensajes de seguimiento.
listeners	Contiene agentes de escucha que recopilan, almacenan y enrutan mensajes. Los agentes de escucha dirigen el resultado del seguimiento a un destino apropiado.

Comentarios

El elemento <clear> quita todos los agentes de escucha de la colección Listeners para seguimiento. Puede utilizar el elemento <clear> antes de utilizar el elemento <add> para asegurarse de que no hay ningún otro agente de escucha activo en la colección.

Puede borrar mediante programación la colección Listeners llamando al método Clear de la propiedad Trace.Listeners (System.Diagnostics.Trace.Listeners.Clear()).

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.

Nota

El elemento <clear> quita DefaultTraceListener de la colección Listeners, modificando el comportamiento de los métodos Debug.Assert, Trace.Assert, Debug.Fail y Trace.Fail. Llamar a un método Assert o Fail normalmente desencadena la aparición de un cuadro de mensaje. Sin embargo, el cuadro de mensaje no se muestra si DefaultTraceListener no está en la colección Listeners.

Ejemplo

El ejemplo siguiente muestra cómo utilizar el elemento <clear> antes de usar el elemento <add> para agregar el agente de escucha console a la colección Listeners para el origen de seguimiento.

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        </clear>
        <add name="console" 
          type="System.Diagnostics.ConsoleTraceListener" >
          <filter type="System.Diagnostics.EventTypeFilter" 
            initializeData="Error" />
        </add>
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>