Esta documentación está archivada y no tiene mantenimiento.

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

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

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.

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.

ms229453.alert_note(es-es,VS.90).gifNota:

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.

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