Elemento <add> para <sharedListeners>

Artículo
12/12/2008

Actualización: noviembre 2007

Agrega un agente de escucha a la colección sharedListeners. sharedListeners es una colección de agentes de escucha a los que puede hacer referencia cualquier <source> (Elemento) o Elemento <trace>. De forma predeterminada, los agentes de escucha de la colección sharedListeners no se colocan en una colección Listeners. Deben agregarse por nombre al <source> (Elemento) o Elemento <trace>. No es posible obtener los agentes de escucha en la colección sharedListeners mediante código en tiempo de ejecución.

<configuration> (Elemento)
  Elemento <system.diagnostics>
    <sharedListeners> (Elemento)
      Elemento <add> de <listeners> de <source>

<add name="name" 
  type="TraceListenerClassName, Version, Culture, PublicKeyToken"
  initializeData="data"/>

Atributos y elementos

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

Atributos

Atributo	Descripción
name	Atributo necesario. Especifica el nombre del agente de escucha utilizado para agregar el agente de escucha compartido a una colección Listeners.
type	Atributo necesario. Especifica el tipo del agente de escucha. Debe utilizar una cadena que cumpla los requisitos enumerados en Especificar nombres de tipo completos.
initializeData	Atributo opcional. Cadena pasada al constructor de la clase especificada.

name

Atributo necesario.

Especifica el nombre del agente de escucha utilizado para agregar el agente de escucha compartido a una colección Listeners.

type

Atributo necesario.

Especifica el tipo del agente de escucha. Debe utilizar una cadena que cumpla los requisitos enumerados en Especificar nombres de tipo completos.

initializeData

Atributo opcional.

Cadena pasada al constructor de la clase especificada.

Elementos secundarios

Elemento	Descripción
Elemento <filter> de <add> de <sharedListeners>	Agrega un filtro a un agente de escucha contenido en la colección sharedListeners.

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.
sharedListeners	Colección de agentes de escucha a los que puede hacer referencia cualquier origen o elemento de seguimiento.

Comentarios

Las clases de agente de escucha incluidas en .NET Framework se derivan de la clase TraceListener. El valor del atributo name se utiliza para agregar el agente de escucha compartido a una colección Listeners para un seguimiento o un origen de seguimiento. El valor del atributo initializeData depende del tipo de agente de escucha que se cree. No todos los agentes de escucha de seguimiento requieren que se especifique initializeData.

Nota

Cuando se utiliza el atributo initializeData, puede que aparezca la advertencia del compilador "No se ha declarado el atributo 'initializeData'". Esta advertencia se produce porque los valores de configuración se validan con la clase base abstracta TraceListener, que no reconoce el atributo initializeData. Normalmente, se puede omitir esta advertencia para las implementaciones de agentes de escucha de seguimiento con un constructor que toma un parámetro.

En la tabla siguiente se muestran los agentes de escucha de seguimiento incluidos en .NET Framework y se describe el valor de sus atributos initializeData.

Clase de agente de escucha de seguimiento	Valor del atributo initializeData
ConsoleTraceListener	El valor de useErrorStream para el constructor ConsoleTraceListener. Establezca el atributo initializeData en "true" para escribir los resultados del seguimiento y la depuración en la secuencia estándar de error; establézcalo en "false" para escribir en la secuencia estándar de salida.
DelimitedListTraceListener	Nombre del archivo en el que escribe DelimitedListTraceListener.
System.Diagnostics.EventLogTraceListener	Nombre de un origen de registro de eventos existente.
System.Diagnostics.EventSchemaTraceListener	Nombre del archivo en el que escribe EventSchemaTraceListener.
System.Diagnostics.TextWriterTraceListener	Nombre del archivo en el que escribe TextWriterTraceListener.
XmlWriterTraceListener	Nombre del archivo en el que escribe XmlWriterTraceListener.

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 elementos <add> para agregar el textListener de TextWriterTraceListener a la colección sharedListeners. textListener se agrega por nombre a la colección Listeners para el origen de seguimiento TraceSourceApp. El agente de escucha textListener escribe el resultado del seguimiento en el archivo myListener.log.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceSourceApp" switchName="sourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener"/>
          <add name="textListener"/>
          <remove name="Default"/>
        </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>