<agregar> Elemento para <sharedListeners>

  • Artículo

Agrega un agente de escucha a la colección sharedListeners. sharedListenerses una colección de agentes de escucha a los que puede hacer referencia cualquier <origen> o <seguimiento>. 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 <origen>o al <seguimiento>. No es posible obtener los agentes de escucha en la colección sharedListeners en el código en tiempo de ejecución.

<configuración>
  <system.diagnostics>
    <sharedListeners>
      <agregar>

Sintaxis

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

Atributos y elementos

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

Atributos

Atributo Descripción
name Atributo necesario.

Especifica el nombre del agente de escucha que se usa para agregar el agente de escucha compartido a una colección Listeners.
type Atributo necesario.

Especifica el tipo de agente de escucha. Debes usar una cadena que cumpla los requisitos especificados en Especificar nombres de tipo completos.
initializeData Atributo opcional.

La cadena pasada al constructor para la clase especificada.
traceOutputOptions Atributo opcional.

Representación de cadena de uno o varios TraceOptions miembros de enumeración que indican los datos que se van a escribir en la salida de seguimiento. Varios elementos están separados por comas. El valor predeterminado es «None».

Elementos secundarios

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

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, así como el nivel en el que está establecido un modificador de seguimiento.
sharedListeners Una colección de los agentes de escucha a los que puede hacer referencia cualquier origen o elemento de seguimiento.

Comentarios

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

Nota

Al usar el atributo initializeData, puede obtener la advertencia del compilador «El atributo 'initializeData' no se declara». 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, puede omitir esta advertencia para las implementaciones del agente de escucha de seguimiento que tienen un constructor que toma un parámetro.

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

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

Archivo de configuración

Este elemento se puede usar en el archivo de configuración del equipo (Machine.config) o en el archivo de configuración de la aplicación.

Ejemplo

En el ejemplo siguiente se muestra cómo usar <add> elementos para agregar a TextWriterTraceListenertextListener 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 la salida de 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>

Consulte también