<system.diagnostics> 元素

指定收集、存储和路由消息的跟踪侦听器以及设置跟踪开关的级别。

<配置><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 中,可以使用文本来指定开关的值。 例如,可以指定 trueBooleanSwitch 使用表示枚举值的文本,例如 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>

另请参阅