Elemento <trace>

Artículo
12/12/2008

Actualización: noviembre 2007

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

<configuration> (Elemento)
Elemento <system.diagnostics>
Elemento <trace>

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

Atributos y elementos

Las siguientes secciones describen atributos, elementos secundarios y elementos primarios.

Atributos

Atributo	Descripción
autoflush	Atributo opcional. Especifica si los agentes de escucha de seguimiento vacían automáticamente o no el búfer de resultados 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 se debe utilizar el bloqueo global.

autoflush

Atributo opcional.

Especifica si los agentes de escucha de seguimiento vacían automáticamente o no el búfer de resultados 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 se debe utilizar el bloqueo global.

Atributo autoflush

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

Atributo useGlobalLock

Valor	Descripción
false	No utiliza el bloqueo global si el agente de escucha es seguro para subprocesos; en caso contrario, utiliza el bloqueo global.
true	Utiliza el bloqueo global sin tener en cuenta si el agente de escucha es seguro para subprocesos. Éste es el valor predeterminado.

Elementos secundarios

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

Elementos primarios

Elemento	Descripción
configuration	Es el elemento raíz de cada archivo de configuración que utilizan las aplicaciones 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.

Ejemplo

En el ejemplo siguiente se muestra cómo usar el elemento <trace> para agregar el agente de escucha MyListener a la colección Listeners. MyListener crea un archivo denominado MyListener.log y escribe el resultado en el archivo. El atributo useGlobalLock está establecido en false, lo que provoca que no se utilice el bloqueo global si el agente de escucha de seguimiento es seguro para subprocesos. El atributo autoflush se establece en true, lo que provoca que el agente de escucha de seguimiento escriba en el archivo, independientemente de que se llame o no al método Trace.Flush. El atributo indentsize está establecido en 0 (cero), lo que provoca que el agente de escucha aplique una sangría de cero espacios cuando se llama 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>