指定收集、存储和路由消息的侦听器。 侦听器将跟踪输出定向到适当的目标。
<configuration>
<system.diagnostics>
<trace>
<listeners>
Syntax
<listeners>
<add>...</add>
<clear/>
<remove ... />
</listeners>
特性和元素
下列各节描述了特性、子元素和父元素。
特性
没有。
子元素
| 元素 | Description |
|---|---|
| <加> | 将侦听器添加到 Listeners 集合。 |
| <清楚> | 清除用于跟踪的 Listeners 集合。 |
| <删除> | 从 Listeners 集合中删除侦听器。 |
父元素
| 元素 | Description |
|---|---|
configuration |
公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。 |
system.diagnostics |
指定 ASP.NET 配置节的根元素。 |
trace |
包含收集、存储和路由跟踪消息的侦听器。 |
注解
和DebugTrace类共享同一Listeners集合。 如果将侦听器对象添加到其中一个类中的集合，则另一个类使用相同的侦听器。 .NET Framework 附带的侦听器类派生自该 TraceListener 类。
配置文件
此元素可用于计算机配置文件（Machine.config）和应用程序配置文件。
Example
以下示例演示如何使用 <listeners> 元素将侦听器 MyListener 和 MyEventListener 集合添加到 Listeners 集合。
MyListener 创建一个调用 MyListener.log 的文件，并将输出写入文件。
MyEventListener 在事件日志中创建一个条目。
<configuration>
<system.diagnostics>
<trace 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" />
<add name="MyEventListener"
type="System.Diagnostics.EventLogTraceListener,
system, version=1.0.3300.0, Culture=neutral,
PublicKeyToken=b77a5c561934e089"
initializeData="MyConfigEventLog"/>
</listeners>
</trace>
</system.diagnostics>
</configuration>
