<agrega> Elemento para <agentes de escucha> para <seguimiento>

  • Artículo

Agrega un agente de escucha a la colección Agentes de Escucha.

<configuración>
  <system.diagnostics>
    <seguimiento>
      <agentes de escucha>
        <agregar>

Sintaxis

<add name="name"
     type="trace listener class name, Version, Culture, PublicKeyToken"  
     initializeData="data"/>

Atributos y elementos

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 de agente de escucha. Debes usar una cadena que cumpla los requisitos especificados en Specifying Fully Qualified Type Names.
initializeData Atributo opcional.

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

Especifica el nombre del agente de escucha.

Elementos secundarios

Elemento Descripción
<filtro> Agrega un filtro a un cliente de escucha en la colección Listeners para un seguimiento.

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.
listeners Especifica un agente de escucha que recopila, almacena y enruta mensajes. Los agentes de escucha dirigen los resultados del seguimiento a un destino apropiado.
system.diagnostics Especifica el elemento raíz de la sección de configuración de ASP.NET.
trace Contiene agentes de escucha que recopilan, almacenan y enrutan los mensajes de seguimiento.

Comentarios

Las clases Debug y Trace comparten la misma colección de agentes de escucha. Si agregas un objeto de escucha a la colección en una de estas clases, la otra clase usa el mismo agente de escucha. Las clases de agente de escucha derivan de TraceListener.

Si no especificas el atributo name del agente de escucha de seguimiento, la propiedad Name del agente de escucha de seguimiento tiene como valor predeterminado una cadena vacía (""). Si la aplicación solo tiene un agente de escucha, puedes agregarlo sin especificar un nombre y quitarlo especificando una cadena vacía para el nombre. Sin embargo, si tu aplicación tiene más de un agente de escucha, debes especificar nombres únicos para cada agente de rastreo, lo que te permite identificar y gestionar agentes de escucha de rastreo individuales dentro de las colecciones Listenersy Listeners.

Nota

Al agregar más de un agente de escucha de seguimiento del mismo tipo y con el mismo nombre, solo se agrega un agente de escucha de seguimiento de ese tipo y nombre a la colección Listeners. 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 crees. 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
System.Diagnostics.ConsoleTraceListener El valor useErrorStream del constructor ConsoleTraceListener. Establezca el initializeData atributo en «true» para escribir la salida de seguimiento y depuración en Console.Error; «false» para escribir en Console.Out.
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 EventSchemaTraceListener va a escribir.
System.Diagnostics.TextWriterTraceListener Nombre del archivo en el que TextWriterTraceListener va a escribir.
System.Diagnostics.XmlWriterTraceListener Nombre del archivo en el que XmlWriterTraceListener va a escribir.

Ejemplo

En el ejemplo siguiente se muestra cómo usar el elemento <agente de escucha> para agregar los agentes MyListener y MyEventListener a la colección Agentes de escucha. MyListener crea un archivo denominado MyListener.log y escribe la salida en el archivo. MyEventListener crea una entrada en el registro de eventos.

<configuration>  
   <system.diagnostics>  
      <trace autoflush="true" indentsize="0">  
         <listeners>  
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />  
            <add name="MyEventListener"  
                 type="System.Diagnostics.EventLogTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"                 initializeData="MyConfigEventLog"/>  
            <add name="configConsoleListener"  
                 type="System.Diagnostics.ConsoleTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

Consulte también