<system.diagnostics> 元素

  • 项目

更新：2007 年 11 月

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

<configuration> 元素
  <system.diagnostics> 元素

<system.diagnostics> 
</system.diagnostics>

属性和元素

以下几节描述了属性、子元素和父元素。

属性

无。

子元素

元素

说明

<assert>

指定在调用 Debug.Assert 方法时是否显示消息框；还指定要将消息写入的文件的名称。

<performanceCounters>

指定由性能计数器共享的全局内存的大小。

<sharedListeners>

包含任何源或跟踪元素都能引用的侦听器。标识为共享侦听器的侦听器可按名称添加到源或跟踪。

<sources>

指定启动跟踪消息的跟踪源。

<switches>

包含跟踪开关以及设置跟踪开关的级别。

<trace>

包含对跟踪消息进行收集、存储和路由的侦听器。

父元素

元素

说明

configuration

公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中的根元素。

示例

下面的示例说明如何将跟踪开关和跟踪侦听器嵌入到 <system.diagnostics> 元素内。General 跟踪开关被设置为 TraceLevel.Error 级别。跟踪侦听器 myListener 创建名为 MyListener.log 的文件并将输出写入该文件。

说明：

在 .NET Framework 2.0 版中，可以使用文本为开关指定值。例如，您可以为 BooleanSwitch 指定 true，或将表示枚举值的文本，（如 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>

请参见

参考

跟踪和调试设置架构

Trace

Debug