Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés

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

 

Borra la colección Listeners para traza.

<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, y el nivel donde se establece un modificador de seguimiento.

trace

Contiene agentes de escucha que recopilan, almacenan y enrutan mensajes de traza.

listeners

Contiene agentes de escucha que recopilan, almacenan y enrutan mensajes. Los agentes de escucha dirigen el resultado de la traza a un destino apropiado.

El elemento <clear> quita todos los agentes de escucha de la colección Listeners para traza. 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.

System_CAPS_noteNota

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 traza.

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