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 <trace>

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

<add name="name" 
     type="trace listener class name, 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. Se debe utilizar una cadena que cumpla los requisitos especificados en Especificar nombres de tipo completos.

initializeData

Atributo opcional.

Cadena pasada al constructor de la clase especificada.

nombre

Atributo opcional.

Especifica el nombre del agente de escucha.

Elementos secundarios

Elemento

Descripción

Elemento <filter> de <add> de <listeners> de <trace>

Agrega un filtro a un agente de escucha de la colección Listeners para una 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.

listeners

Especifica un agente de escucha que recopila, almacena y enruta mensajes. Los agentes de escucha dirigen el resultado de la traza 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 mensajes de traza.

Las clases Debug y Trace comparten la misma colección Listeners. Si se agrega un objeto de agente de escucha a la colección en una de estas clases, la otra clase utilizará el mismo agente de escucha. Las clases de agente de escucha derivan de la clase TraceListener.

Si no especifica el atributo name del agente de escucha de traza, el atributo Name del agente de escucha de traza tiene como valor predefinido 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 nombres únicos para cada agente de escucha de traza, de forma que pueda identificar y administrar los agentes de escucha de traza individualmente dentro de las colecciones Listeners y 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 traza y depuración en Console.Error; establézcalo en "false" para escribir en Console.Out.

System.Diagnostics.DelimitedListTraceListener

Nombre del archivo en el que DelimitedListTraceListener va a escribir.

System.Diagnostics.EventLogTraceListener

El nombre del nombre de un origen de registro de eventos existente.

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.

El ejemplo siguiente se muestra cómo utilizar los elementos de <agregar> para agregar agentes de escucha MyListener y MyEventListener a la colección de Listeners . MyListener crea un archivo denominado MyListener.log y escribe el resultado 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>

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft