<source> 元素

指定启动跟踪消息的跟踪源。

<source> 
  <listeners>...</listeners>
</source>

特性和元素

以下几节描述了属性、子元素和父元素。

特性

特性	说明
name	可选特性。 指定跟踪源的名称。
switchName	可选特性。 指定应用程序中的跟踪开关实例的名称。 如果未在某个 <switches> 元素中标识该开关，则该值指定开关的级别。
switchType	可选特性。 指定跟踪开关的类型。 如存在，该类型必须是有效的类名，并且不能是空字符串。
extraAttribute	可选特性。 指定由跟踪源的 GetSupportedAttributes 方法所标识的特定于跟踪源的特性的值。

子元素

元素	说明
<trace> 的 <listeners> 元素	包含对消息进行收集、存储和路由的侦听器。

父元素

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

备注

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

示例

下面的示例演示如何使用 <source> 元素添加跟踪源 mySource 并设置名为 sourceSwitch 的源开关的级别。 添加了一个控制台跟踪侦听器，该侦听器将跟踪信息写到控制台。

<configuration>
  <system.diagnostics>
    <sources>
      <source name="mySource" switchName="sourceSwitch" switchType="System.Diagnostics.SourceSwitch"  >
        <listeners>
          <add name="console" type="System.Diagnostics.ConsoleTraceListener" >
            <filter type="System.Diagnostics.EventTypeFilter" initializeData="Error" />
          </add>
          <remove name="Default" />
        </listeners>
      </source>
    </sources>
        <switches>
           <add name="sourceSwitch" value="Warning" />
        </switches>  
  </system.diagnostics> 
</configuration>

请参见

参考

跟踪和调试设置架构

概念

Trace Sources

跟踪开关