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