Elemento <system.diagnostics>

Artículo
08/10/2011

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

<system.diagnostics> 
</system.diagnostics>

Atributos y elementos

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

Atributos

Ninguno.

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 traza. Los agentes de escucha identificados como agentes de escucha compartidos se pueden agregar por nombre a los orígenes o trazas.
<sources>	Especifica orígenes de traza que inician mensajes de traza.
<switches>	Contiene modificadores de traza y los niveles donde éstos se establecen.
<trace>	Contiene agentes de escucha que recopilan, almacenan y enrutan mensajes de traza.

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 siguiente ejemplo se muestra cómo incrustar un modificador de traza y un agente de escucha de traza dentro del elemento <system.diagnostics>. El modificador de traza General se establece en el nivel TraceLevel.Error. El agente de escucha de traza 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

Share via