<system.diagnostics> Element

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework General Reference

<system.diagnostics> Element

Specifies trace listeners that collect, store, and route messages and the level where a trace switch is set.

<configuration> Element
<system.diagnostics> Element

<system.diagnostics> 
</system.diagnostics>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child Elements

Element	Description
<assert>	Specifies whether to display a message box when you call the Debug..::.Assert method; also specifies the name of the file to write messages to.
<performanceCounters>	Specifies the size of the global memory shared by performance counters.
<sharedListeners>	Contains listeners that any source or trace element can reference. Listeners identified as shared listeners can be added to sources or traces by name.
<sources>	Specifies trace sources that initiate tracing messages.
<switches>	Contains trace switches and the levels where the trace switches are set.
<trace>	Contains listeners that collect, store, and route tracing messages.

Parent Elements

Element	Description
configuration	The root element in every configuration file used by the common language runtime and .NET Framework applications.

Example

The following example shows how to embed a trace switch and a trace listener inside the <system.diagnostics> element. The General trace switch is set to the TraceLevel.Error level. The trace listener myListener creates a file called MyListener.log and writes the output to the file.

Note:
In the .NET Framework version 2.0, you can use text to specify the value for a switch. For example, you can specify true for a BooleanSwitch or use the text representing an enumeration value such as Error for a TraceSwitch. The line <add name="myTraceSwitch" value="Error" /> is equivalent to <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>

Reference

Trace and Debug Settings Schema

Trace

Debug