Elemento <trace>

Artículo
08/10/2011

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

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

Atributos y elementos

En las secciones siguientes 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 traza 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 traza 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	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 traza que recopilan, almacenan y enrutan mensajes, y el nivel donde se establece un modificador de traza.

Ejemplo

En los ejemplos siguientes se muestra el uso del 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 traza es seguro para subprocesos. El atributo autoflush se establece en true, lo que provoca que el agente de escucha de traza 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>