<trace> -> <listeners> 元素

更新：2007 年 11 月

指定对消息进行收集、存储和路由的侦听器。侦听器将跟踪输出定向到合适的目标。

<configuration> 元素
  <system.diagnostics> 元素
    <trace> 元素
      <trace> -> <listeners> 元素

<listeners> 
  <add>...</add>
  <clear/>
  <remove ... />
</listeners>

属性和元素

下面几部分描述了属性、子元素和父元素。

属性

无。

子元素

元素	说明
<trace> -> <listeners> -> <add> 元素	将侦听器添加到 Listeners 集合中。
<trace> -> <listeners> -> <clear> 元素	清除跟踪的 Listeners 集合。
<trace> -> <listeners> -> <remove> 元素	从 Listeners 集合中移除侦听器。

父元素

元素	说明
configuration	公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
system.diagnostics	为 ASP.NET 配置节指定根元素。
trace	包含对跟踪消息进行收集、存储和路由的侦听器。

备注

Debug 和 Trace 类共享同一个 Listeners 集合。如果将侦听器对象添加到其中一个类的集合中，其他类则会使用相同的侦听器。随 .NET Framework 一起提供的侦听器类从 TraceListener 类派生。

配置文件

此元素可用于计算机配置文件 (Machine.config) 和应用程序配置文件。

示例

下面的示例说明如何使用 <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>

请参见

参考

跟踪和调试设置架构

TraceListener