Elemento <system.diagnostics>

  • Artículo

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.

<configuration>
  <system.diagnostics>

Sintaxis

<system.diagnostics>
</system.diagnostics>

Atributos y elementos

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

Atributos

Ninguno.

Elementos secundarios

Elemento Descripción
<assert> Especifica si se muestra un cuadro de mensaje cuando se llama al método Debug.Assert; también indica el nombre del archivo para el que se van a escribir los mensajes.
<performanceCounters> Especifica el tamaño de la memoria global que comparten los contadores de rendimiento.
<sharedListeners> Contiene los agentes de escucha a los que puede hacer referencia cualquier origen o elemento de seguimiento. Los clientes de escucha identificados como clientes de escucha compartidos se pueden agregar a orígenes o seguimientos por nombre.
<sources> Especifica orígenes de seguimiento que inician mensajes de seguimiento.
<switches> Contiene modificadores de seguimiento y el nivel en el que están establecidos.
<trace> Contiene agentes de escucha que recopilan, almacenan y enrutan los mensajes de seguimiento.

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.

Ejemplo

En el ejemplo siguiente se muestra cómo insertar un modificador de seguimiento y un agente de escucha de seguimiento dentro del elemento <system.diagnostics>. El modificador de seguimiento General se establece en el nivel TraceLevel. El agente de escucha de seguimiento myListener crea un archivo denominado MyListener.log y escribe la salida en el archivo.

Nota

En la versión 2.0 de .NET Framework, puede utilizar texto para especificar el valor de un modificador. Por ejemplo, puede especificar true para un BooleanSwitch o el texto que representa un valor de enumeración como Error para un TraceSwitch. La línea <add name="myTraceSwitch" value="Error" /> es equivalente a <add name="myTraceSwitch" value="1" />.

<configuration>  
   <system.diagnostics>  
      <switches>  
         <add name="General" value="4" />  
      </switches>  
      <trace autoflush="true" indentsize="2">  
         <listeners>  
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="MyListener.log" traceOutputOptions="ProcessId, LogicalOperationStack, Timestamp, ThreadId, Callstack, DateTime" />  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

Consulte también