<agregar> (elemento) para <los agentes de escucha> para <origen><add> Element for <listeners> for <source>

Agrega un agente de escucha a la colección Listeners para un origen de seguimiento.Adds a listener to the Listeners collection for a trace source.

<configuration><configuration>
<System.Diagnostics ><system.diagnostics>
<orígenes ><sources>
<origen ><source>
<los agentes de escucha ><listeners>
<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
type Requiere el atributo, a menos que se está haciendo referencia a un agente de escucha en el sharedListeners colección, en el que caso, solo tiene que hacer referencia a él por su nombre (vea la ejemplo).Required attribute, unless you're referencing a listener in the sharedListeners collection, in which case you only need to refer to it by name (see the Example).

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. Un ConfigurationException se produce si la clase no tiene un constructor que toma una cadena.A ConfigurationException is thrown if the class does not have a constructor that takes a string.
name Atributo opcional.Optional attribute.

Especifica el nombre del agente de escucha.Specifies the name of the listener.
traceOutputOptions Atributo opcional.Optional attribute.

Especifica la TraceOutputOptions valor de propiedad para el agente de escucha de seguimiento.Specifies the TraceOutputOptions property value for the trace listener.
[atributos personalizados][custom attributes] Atributos opcionales.Optional attributes.

Especifica el valor para atributos específicos del agente de escucha identificados por el GetSupportedAttributes método para ese agente de escucha.Specifies the value for listener-specific attributes identified by the GetSupportedAttributes method for that listener. Delimiteres un ejemplo de un atributo adicional único para la DelimitedListTraceListener clase.Delimiter is an example of an extra attribute unique to the DelimitedListTraceListener class.

Elementos secundariosChild Elements

ElementoElement DescripciónDescription
<filter><filter> Agrega un filtro a un agente de escucha en la colección Listeners para un origen de seguimiento.Adds a filter to a listener in the Listeners collection for a trace source.

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.
sources Contiene orígenes de seguimiento que inician mensajes de seguimiento.Contains trace sources that initiate tracing messages.
source Contiene un origen de seguimiento que inicia mensajes de seguimiento.Specifies a trace source that initiates tracing messages.
listeners Especifica los agentes de escucha que recopilarán, almacenan y enrutan los mensajes.Specifies listeners that collect, store, and route messages.

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.

Si no se especifica la name atributo del agente de escucha de seguimiento, la Name la propiedad del agente de escucha de seguimiento es una cadena vacía ("").If you do not specify the name attribute of the trace listener, the Name property of the trace listener defaults to an empty string (""). Si la aplicación tiene sólo un agente de escucha, puede agregarlo sin especificar un nombre y quitarlo especificando una cadena vacía para el nombre.If your application has only one listener, you can add it without specifying a name, and you can remove it by specifying an empty string for the name. Sin embargo, si la aplicación tiene más de un agente de escucha, debe especificar un nombre único para cada agente de escucha de seguimiento, lo que permite identificar y administrar los agentes de escucha de seguimiento individuales de la TraceSource.Listeners colección.However, if your application has more than one listener, you should specify a unique name for each trace listener, which allows you to identify and manage individual trace listeners in the TraceSource.Listeners collection.

Nota

Agregar más de un agente de escucha de seguimiento del mismo tipo y con el mismo nombre da como resultado un único agente de escucha de ese tipo y nombre que se va a agregar a la Listeners colección.Adding more than one trace listener of the same type and with the same name results in only one trace listener of that type and name being added to the Listeners collection. Sin embargo, puede agregar mediante programación varios agentes de escucha idénticos a los Listeners colección.However, you can programmatically add multiple identical listeners to the Listeners collection.

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
System.Diagnostics.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.
System.Diagnostics.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.
System.Diagnostics.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 agregan los agentes de escucha console y textListener a la Listeners colección para el origen de seguimiento TraceSourceApp.The following example shows how to use <add> elements to add the listeners console and textListener 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