<system.diagnostics> 元素
指定用于收集、存储和路由消息的跟踪侦听器以及对跟踪开关设置的级别。
configuration
<system.diagnostics>
语法
<system.diagnostics>
</system.diagnostics>
特性和元素
下列各节描述了特性、子元素和父元素。
特性
无。
子元素
元素 | 说明 |
---|---|
<assert> | 指定调用 Debug.Assert 方法时是否显示消息框;另外指定要写入消息的文件的名称。 |
<performanceCounters> | 指定由性能计数器共享的全局内存的大小。 |
<sharedListeners> | 包含任何源或跟踪元素可以引用的侦听器。 标识为共享侦听器的侦听器可以按名称添加到源或跟踪。 |
<sources> | 指定用于启动跟踪消息的跟踪源。 |
<switches> | 包含跟踪开关和对该跟踪开关设置的级别。 |
<trace> | 包含用于收集、存储和路由跟踪消息的侦听器。 |
父元素
元素 | 说明 |
---|---|
configuration |
公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。 |
示例
下面的示例演示如何将跟踪开关和跟踪侦听器嵌入 <system.diagnostics> 元素。 将 General
跟踪开关设置为 TraceLevel 级别。 跟踪侦听器 myListener
创建名为 MyListener.log
的文件,并将输出写入该文件。
注意
在 .NET Framework 2.0 版中,你可以使用文本指定开关值。 例如,可以为 BooleanSwitch 指定 true
或使用表示枚举值的文本,例如为 TraceSwitch 指定 Error
。 行 <add name="myTraceSwitch" value="Error" />
等于 <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>