<seguimiento> elemento<trace> Element

Contiene agentes de escucha que recopilan, almacenan y enrutan los mensajes de seguimiento.Contains listeners that collect, store, and route tracing messages.

<configuration><configuration>
<System.Diagnostics ><system.diagnostics>
<seguimiento ><trace>

SintaxisSyntax

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

Atributos y elementosAttributes and Elements

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DescripciónDescription
autoflush Atributo opcional.Optional attribute.

Especifica si los agentes de escucha de seguimiento vacían automáticamente o el búfer de salida después de cada operación de escritura.Specifies whether the trace listeners automatically flush the output buffer after every write operation.
indentsize Atributo opcional.Optional attribute.

Especifica el número de espacios para la sangría.Specifies the number of spaces to indent.
useGlobalLock Atributo opcional.Optional attribute.

Indica si se debe utilizar el bloqueo global.Indicates whether the global lock should be used.

Atributo autoflushautoflush Attribute

ValorValue DescripciónDescription
false No se vacíe automáticamente el búfer de salida.Does not automatically flush the output buffer. Este es el valor predeterminado.This is the default.
true Automáticamente se vacía el búfer de salida.Automatically flushes the output buffer.

Atributo useGlobalLockuseGlobalLock Attribute

ValorValue DescripciónDescription
false No utiliza el bloqueo global si el agente de escucha es seguro para subprocesos; en caso contrario, utiliza el bloqueo global.Does not use the global lock if the listener is thread safe; otherwise, uses the global lock.
true Utiliza el bloqueo global independientemente de si el agente de escucha es seguro para subprocesos.Uses the global lock regardless of whether the listener is thread safe. Este es el valor predeterminado.This is the default.

Elementos secundariosChild Elements

ElementoElement DescripciónDescription
<listeners><listeners> Especifica un agente de escucha que recopila, almacena y enruta los mensajes.Specifies a listener that collects, stores, and routes messages.

Elementos primariosParent Elements

ElementoElement DescripciónDescription
configuration Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
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.Specifies trace listeners that collect, store, and route messages and the level where a trace switch is set.

EjemploExample

En el ejemplo siguiente se muestra cómo utilizar el <trace> elemento que se va a agregar el agente de escucha MyListener a la Listeners colección.The following example shows how to use the <trace> element to add the listener MyListener to the Listeners collection. MyListener crea un archivo que se denomina MyListener.log y escribe el resultado en el archivo.MyListener creates a file that is named MyListener.log and writes the output to the file. El useGlobalLock atributo está establecido en false, lo que hace que el bloqueo global no que se utilizará si el agente de escucha de seguimiento es seguro para subprocesos.The useGlobalLock attribute is set to false, which causes the global lock not to be used if the trace listener is thread safe. El autoflush atributo está establecido en true, lo que hace que el agente de escucha de seguimiento escribir en el archivo independientemente de si el Trace.Flush se llama al método.The autoflush attribute is set to true, which causes the trace listener to write to the file regardless of whether the Trace.Flush method is called. El indentsize atributo está establecido en 0 (cero), lo que hace que el agente de escucha sangre cero espacios cuando el Trace.Indent se llama al método.The indentsize attribute is set to 0 (zero), which causes the listener to indent zero spaces when the Trace.Indent method is called.

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

Vea tambiénSee Also

TraceListener
DefaultTraceListener
TextWriterTraceListener
EventLogTraceListener
Esquema de la configuración de seguimiento y depuraciónTrace and Debug Settings Schema