Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

Elemento <add> de <listeners> de <source>

Agrega un agente de escucha a la colección Listeners de un origen de traza.

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

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

Atributos

Atributo

Descripción

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. Si la clase no tiene un constructor que toma una cadena, se inicia una excepción ConfigurationException.

name

Atributo opcional.

Especifica el nombre del agente de escucha.

traceOutputOptions

Atributo opcional.

Especifica el valor de propiedad TraceOutputOptions para el agente de escucha de traza.

[atributos personalizados]

Atributos opcionales.

Especifica el valor para los atributos específicos del agente de escucha identificados por el método GetSupportedAttributes de ese agente de escucha. Delimiter es un ejemplo de un atributo adicional único de la clase DelimitedListTraceListener.

Elementos secundarios

Elemento

Descripción

Elemento <filter> para <add> de <listeners> de <source>

Agrega un filtro a un agente de escucha de la colección Listeners para un origen de traza.

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, y el nivel donde se establece un modificador de seguimiento.

sources

Contiene orígenes de traza que inician mensajes de traza.

source

Especifica un origen de traza que inicia mensajes de traza.

listeners

Especifica agentes de escucha que recopilan, almacenan y enrutan mensajes.

Las clases de agente de escucha incluidas en .NET Framework se derivan de la clase TraceListener.

Si no especifica el atributo name del agente de escucha de traza, la propiedad Name del agente de escucha de traza tiene como valor predeterminado una cadena vacía (""). Si su 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. Sin embargo, si su aplicación tiene más de un agente de escucha, debe especificar un nombre único para cada agente de escucha de traza, de forma que pueda identificar y administrar los agentes de escucha de traza individualmente dentro de la colección TraceSource.Listeners.

Nota Nota

Agregar más de un agente de escucha de traza del mismo tipo y con el mismo nombre tiene como resultado que sólo se agregue a la colección Listeners un agente de escucha de traza con ese tipo y nombre. Sin embargo, puede agregar mediante programación varios agentes de escucha idénticos a la colección Listeners.

El valor del atributo initializeData depende del tipo de agente de escucha que se cree. No todos los agentes de escucha de traza requieren que se especifique initializeData.

Nota Nota

Cuando se utiliza el atributo initializeData, puede aparecer la advertencia del compilador "No se ha declarado el atributo 'initializeData'". Esta advertencia se produce porque la configuración se valida con arreglo a la clase base abstracta TraceListener, que no reconoce el atributo initializeData. Por lo general, puede hacer caso omiso de esta advertencia en las implementaciones de agentes de escucha de traza que tienen un constructor que toma un parámetro.

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

Clase de agente de escucha de traza

Valor del atributo initializeData

System.Diagnostics.ConsoleTraceListener

El valor de useErrorStream para el constructor ConsoleTraceListener. Establezca el atributo initializeData en "true" para escribir los resultados de la traza y la depuración en el flujo estándar de error; establézcalo en "false" para escribir en el flujo de salida estándar.

System.Diagnostics.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 escribe EventSchemaTraceListener.

System.Diagnostics.TextWriterTraceListener

Nombre del archivo en el que escribe TextWriterTraceListener.

System.Diagnostics.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.

El ejemplo siguiente muestra cómo utilizar elementos <add> para agregar los agentes de escucha console y textListener a la colección Listeners del origen de traza TraceSourceApp. El agente de escucha textListener escribe el resultado de la traza 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> 

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft