Elemento <clear> de <listeners> de <source>

Artículo
10/07/2008

Actualización: noviembre 2007

Borra la colección Listeners para un origen de seguimiento.

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

<clear/>

Atributos y elementos

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

Atributos

Ninguno.

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 <clear> quita todos los agentes de escucha de la colección Listeners para un origen de seguimiento, incluido DefaultTraceListener. 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.

Archivo de configuración

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 <clear> antes de usar elementos <add> para agregar agentes de escucha console y textListener 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>
          <clear/>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener"/>
          <add name="textListener"/>
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="textListener" 
        type="System.Diagnostics.TextWriterTraceListener" 
        initializeData="myListener.log"/>
    </sharedListeners>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration>