Elemento <system.diagnostics>

Artículo
12/12/2008

Actualización: noviembre 2007

Especifica los agentes de escucha de seguimiento que recopilan, almacenan y enrutan mensajes, y el nivel donde se establece un modificador de seguimiento.

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

<system.diagnostics> 
</system.diagnostics>

Atributos y elementos

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

Atributos

Ninguna.

Elementos secundarios

Elemento	Descripción
<assert>	Especifica si aparecerá o no un cuadro de mensaje al llamar al método Debug.Assert; también especifica el nombre del archivo donde se escriben los mensajes.
<performanceCounters>	Especifica el tamaño de la memoria global compartida por los contadores de rendimiento.
<sharedListeners>	Contiene agentes de escucha a los que puede hacer referencia cualquier origen o elemento de seguimiento. Los agentes de escucha identificados como agentes de escucha compartidos se pueden agregar por nombre a los orígenes o seguimientos.
<sources>	Especifica orígenes de seguimiento que inician mensajes de seguimiento.
<switches>	Contiene modificadores de seguimiento y los niveles donde éstos se establecen.
<trace>	Contiene agentes de escucha que recopilan, almacenan y enrutan mensajes de seguimiento.

Elementos primarios

Elemento	Descripción
configuration	Elemento raíz de cada archivo de configuración que utilizan las aplicaciones Common Language Runtime y .NET Framework.

Ejemplo

En el siguiente ejemplo se muestra cómo incrustar 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.Error. El agente de escucha de seguimiento myListener crea un archivo denominado MyListener.log y escribe el resultado en el archivo.

Nota

En la versión 2.0 de .NET Framework, se puede utilizar texto para especificar el valor de un modificador. Por ejemplo, puede especificar true para BooleanSwitch o el texto que representa un valor de enumeración como Error para 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>

Vea también

Referencia

Esquema de la configuración de seguimiento y depuración

Trace

Debug

Compartir a través de