<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>

请参阅