<seguimiento> Elemento

  • Artículo

Contiene agentes de escucha que recopilan, almacenan y enrutan los mensajes de seguimiento.

<configuración>
  <system.diagnostics>
    <seguimiento>

Sintaxis

<trace autoflush="true|false"
       indentsize="indent value"  
       useGlobalLock="true| false"/>

Atributos y elementos

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

Atributos

Atributo Descripción
autoflush Atributo opcional.

Especifica si los agentes de escucha de seguimiento vacían automáticamente el búfer de salida después de cada operación de escritura.
indentsize Atributo opcional.

Especifica el número de espacios para la sangría.
useGlobalLock Atributo opcional.

Indica si el bloqueo global debería usarse.

Atributo autoflush

Valor Descripción
false No vacía automáticamente el búfer de salida. Este es el valor predeterminado.
true Vacía automáticamente el búfer de salida.

Atributo useGlobalLock

Valor Descripción
false No utiliza el bloqueo global si el agente de escucha es seguro para subprocesos; de lo contrario, usa el bloqueo global.
true Usa el bloqueo global independientemente de si el agente de escucha es seguro para subprocesos. Este es el valor predeterminado.

Elementos secundarios

Elemento Descripción
<agentes de escucha> Especifica un agente de escucha que recopila, almacena y enruta mensajes.

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.

Ejemplo

En el ejemplo siguiente se muestra cómo usar el elemento <trace> para agregar el cliente de escucha MyListener a la colección Listeners. MyListener crea un archivo denominado MyListener.log y escribe la salida en el archivo. El useGlobalLock atributo se establece en false, lo que hace que el bloqueo global no se use si el agente de escucha de seguimiento es seguro para subprocesos. El atributo autoflush se establece en true, lo que hace que el agente de escucha de seguimiento escriba en el archivo independientemente de si se llama al método Trace.Flush. El atributo indentsize se establece en 0 (cero), lo que hace que el agente de escucha sangría cero espacios cuando se llame al método Trace.Indent.

<configuration>  
   <system.diagnostics>  
      <trace useGlobalLock="false" 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" />  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

Consulte también