通过

<trace> 元素

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

<配置><system.diagnostics><跟踪>

Syntax

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

特性和元素

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

特性

Attribute Description
autoflush 可选属性。

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

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

指示是否应使用全局锁。

autoflush 属性

价值 Description
false 不自动刷新输出缓冲区。 这是默认情况。
true 自动刷新输出缓冲区。

useGlobalLock 属性

价值 Description
false 如果侦听器是线程安全的，则不使用全局锁;否则，请使用全局锁。
true 无论侦听器是否为线程安全，都使用全局锁。 这是默认情况。

子元素

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

父元素

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

Example

以下示例演示如何使用 <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>

另请参阅

  • Last updated on