<trace> 的 <listeners> 元素

  • 项目

指定收集、存储和路由消息的侦听器。 侦听器将跟踪输出定向到相应的目标。

configuration
  <system.diagnostics>
    <trace>
      <listeners>

语法

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

特性和元素

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

特性

无。

子元素

元素 说明
<add> 将侦听器添加到 Listeners 集合中。
<clear> 清除跟踪的 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>

请参阅