<agregar> (elemento) para <sharedListeners><add> Element for <sharedListeners>

Agrega un agente de escucha a la colección sharedListeners.Adds a listener to the sharedListeners collection. sharedListenerses una colección de agentes de escucha que cualquier <origen > o <seguimiento > pueden hacer referencia.sharedListeners is a collection of listeners that any <source> or <trace> can reference. De forma predeterminada, los agentes de escucha en el sharedListeners colección no se colocan en un Listeners colección.By default, listeners in the sharedListeners collection are not placed in a Listeners collection. Deben agregarse por el nombre a la <origen > o <seguimiento >.They must be added by name to the <source> or <trace>. No es posible obtener los agentes de escucha el sharedListeners colección en el código en tiempo de ejecución.It is not possible to get the listeners in the sharedListeners collection in code at run time.

<configuration><configuration>
<System.Diagnostics ><system.diagnostics>
<sharedListeners > elemento<sharedListeners> Element
<add><add>

SintaxisSyntax

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

Atributos y elementosAttributes and Elements

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DescripciónDescription
name Atributo necesario.Required attribute.

Especifica el nombre del agente de escucha que se utiliza para agregar el agente de escucha compartido a un Listeners colección.Specifies the name of the listener that is used to add the shared listener to a Listeners collection.
type Atributo necesario.Required attribute.

Especifica el tipo del agente de escucha.Specifies the type of the listener. Debe utilizar una cadena que cumpla los requisitos especificados en especificar nombres de tipo completos.You must use a string that meets the requirements specified in Specifying Fully Qualified Type Names.
initializeData Atributo opcional.Optional attribute.

La cadena pasada al constructor de la clase especificada.The string passed to the constructor for the specified class.

Elementos secundariosChild Elements

ElementoElement DescripciónDescription
<filter><filter> Agrega un filtro a un agente de escucha en la colección sharedListeners.Adds a filter to a listener in the sharedListeners collection.

Elementos primariosParent Elements

ElementoElement DescripciónDescription
configuration Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
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.Specifies trace listeners that collect, store, and route messages and the level where a trace switch is set.
sharedListeners Una colección de agentes de escucha que se puede hacer referencia a cualquier origen o elemento de seguimiento.A collection of listeners that any source or trace element can reference.

ComentariosRemarks

Las clases de agente de escucha incluidas en .NET Framework se derivan de la TraceListener clase.The listener classes shipped with the .NET Framework derive from the TraceListener class. El valor de la name atributo se utiliza para agregar el agente de escucha compartido a un Listeners colección para un seguimiento o un origen de seguimiento.The value for the name attribute is used to add the shared listener to a Listeners collection for either a trace or a trace source. El valor de la initializeData atributo depende del tipo de escucha que se cree.The value for the initializeData attribute depends on the type of listener you create. No todos los agentes de escucha de seguimiento requieren que se especifiquen initializeData.Not all trace listeners require that you specify initializeData.

Nota

Cuando se usa el initializeData atributo, es posible que obtenga el compilador advertencia "no se declaró el atributo 'initializeData'".When you use the initializeData attribute, you may get the compiler warning "The 'initializeData' attribute is not declared." Esta advertencia se produce porque los valores de configuración se validan con la clase base abstracta TraceListener, que no reconoce el initializeData atributo.This warning occurs because the configuration settings are validated against the abstract base class TraceListener, which does not recognize the initializeData attribute. Por lo general, puede omitir esta advertencia para las implementaciones de agente de escucha de seguimiento que tiene un constructor que toma un parámetro.Typically, you can ignore this warning for trace listener implementations that have a constructor that takes a parameter.

En la tabla siguiente muestra los agentes de escucha de seguimiento que se incluyen con .NET Framework y se describe el valor de sus initializeData atributos.The following table shows the trace listeners that are included with the .NET Framework and describes the value of their initializeData attributes.

Clase de agente de escucha de seguimientoTrace listener class valor del atributo initializeDatainitializeData attribute value
ConsoleTraceListener El useErrorStream valor para el ConsoleTraceListener constructor.The useErrorStream value for the ConsoleTraceListener constructor. Establecer el initializeData atribuir a "true"escribir trace y debug de salida en el flujo de error estándar; establézcala en"false" para escribir en el flujo de salida estándar.Set the initializeData attribute to "true" to write trace and debug output to the standard error stream; set it to "false" to write to the standard output stream.
DelimitedListTraceListener El nombre del archivo de la DelimitedListTraceListener escribe en.The name of the file the DelimitedListTraceListener writes to.
System.Diagnostics.EventLogTraceListener El nombre de un origen de registro de eventos existente.The name of an existing event log source.
System.Diagnostics.EventSchemaTraceListener El nombre del archivo que el EventSchemaTraceListener escribe en.The name of the file that the EventSchemaTraceListener writes to.
System.Diagnostics.TextWriterTraceListener El nombre del archivo que el TextWriterTraceListener escribe en.The name of the file that the TextWriterTraceListener writes to.
XmlWriterTraceListener El nombre del archivo que el XmlWriterTraceListener escribe en.The name of the file that the XmlWriterTraceListener writes to.

Archivo de configuraciónConfiguration File

Este elemento se puede usar en el archivo de configuración del equipo (Machine.config) y el archivo de configuración de aplicación.This element can be used in the machine configuration file (Machine.config) and the application configuration file.

EjemploExample

En el ejemplo siguiente se muestra cómo usar <add> elementos que se va a agregar el TextWriterTraceListener textListener a la sharedListeners colección.The following example shows how to use <add> elements to add the TextWriterTraceListenertextListener to the sharedListeners collection. textListenerse agrega por el nombre a la Listeners colección para el origen de seguimiento TraceSourceApp.textListener is added by name to the Listeners collection for the trace source TraceSourceApp. La textListener agente de escucha escribe la salida de seguimiento en el archivo myListener.log.The textListener listener writes trace output to the file 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>   

Vea tambiénSee Also

TraceSource
TraceListener
Esquema de la configuración de seguimiento y depuraciónTrace and Debug Settings Schema
Agentes de escucha de seguimientoTrace Listeners