通过

<source> 元素

  • 项目

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

configuration
  <system.diagnostics>
    <sources>
      <source>

语法

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

特性和元素

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

特性

属性 描述
name 可选特性。

指定跟踪源的名称。
switchName 可选特性。

指定应用程序中跟踪开关实例的名称。 如果 <switches> 元素中未标识开关，则值指定开关的级别。
switchType 可选特性。

指定跟踪开关的类型。 如果存在，则类型必须是有效的类名，不能为空字符串。
extraAttribute 可选特性。

指定由该跟踪源的 GetSupportedAttributes 方法标识的跟踪源特定属性的值。

子元素

元素 说明
<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>

请参阅