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