<trace> 元素

  • 项目

包含用于收集、存储和路由跟踪消息的侦听器。

configuration
  <system.diagnostics>
    <trace>

语法

<trace autoflush="true|false"
       indentsize="indent value"  
       useGlobalLock="true| false"/>

特性和元素

下列各节描述了特性、子元素和父元素。

特性

属性 描述
autoflush 可选特性。

指定跟踪侦听器是否在每次写入操作后自动刷新输出缓冲区。
indentsize 可选特性。

指定要缩进的空格数。
useGlobalLock 可选特性。

指示是否应使用全局锁。

autoflush 属性

值 说明
false 不自动刷新输出缓冲区。 这是默认值。
true 自动刷新输出缓冲区。

useGlobalLock 属性

值 说明
false 如果侦听器是线程安全的，则不使用全局锁；否则，使用全局锁。
true 无论侦听器是否是线程安全的，都使用全局锁。 这是默认值。

子元素

元素 描述
<listeners> 指定收集、存储和路由消息的侦听器。

父元素

元素 说明
configuration 公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
system.diagnostics 指定用于收集、存储和路由消息的跟踪侦听器以及对跟踪开关设置的级别。

示例

下面的示例演示如何使用 <trace> 元素将侦听器 MyListener 添加到 Listeners 集合。 MyListener 创建名为 MyListener.log 的文件并将输出写入该文件。 属性 useGlobalLock 设置为 false，这会导致在跟踪侦听器为线程安全时不使用全局锁。 属性 autoflush 设置为 true，这会导致跟踪侦听器写入文件，而不考虑是否调用 Trace.Flush 方法。 属性 indentsize 设置为 0 (零)，这会导致侦听器在调用 Trace.Indent 方法时缩进零个空格。

<configuration>  
   <system.diagnostics>  
      <trace useGlobalLock="false" autoflush="true" indentsize="0">  
         <listeners>  
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

请参阅