<eliminar> Elemento para <agentes de escucha> para <seguimiento>

  • Artículo

Borra la colección Listeners de un seguimiento.

<configuración>
  <system.diagnostics>
    <seguimiento>
      <agentes de escucha>
        <eliminar>

Sintaxis

<clear/>

Atributos y elementos

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

Atributos

Ninguno.

Elementos secundarios

Ninguno.

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 seguimiento que recopilan, almacenan y enrutan mensajes, así como el nivel en el que está establecido un modificador de seguimiento.
trace Contiene agentes de escucha que recopilan, almacenan y enrutan los mensajes de seguimiento.
listeners Contiene clientes de escucha que recopilan, almacenan y enrutan los mensajes. Los agentes de escucha dirigen los resultados del seguimiento a un destino apropiado.

Comentarios

El <clear> elemento quita todos los agentes de escucha de la colección para el Listeners seguimiento. Puede usar el elemento <clear> antes de usar el elemento <add> para estar seguro de que no hay otros agentes de escucha activos en la colección.

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

Este elemento se puede usar en el archivo de configuración del equipo (Machine.config) o en el archivo de configuración de la aplicación.

Nota

El elemento <clear> quita de DefaultTraceListener la colección Listeners, modificando el comportamiento de los métodos Debug.Assert, Trace.Assert, Debug.Faily Trace.Fail. Llamar a un método Assert o Fail normalmente da como resultado la presentació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

En el ejemplo siguiente se muestra cómo usar el elemento <clear> antes de usar el elemento <add> para agregar el agente de escucha console a la colección Listeners para 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>

Consulte también