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