<source> 元素

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

<配置>
   <system.diagnostics>
     <来源>
       <源>

Syntax

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

特性和元素

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

特性

Attribute Description
name 可选属性。

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

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

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

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

子元素

元素 Description
<听众> 包含收集、存储和路由消息的侦听器。

父元素

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

注解

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

Example

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

另请参阅