Поделиться через


<source> Элемент

Указывает источник трассировки, инициирующий сообщения трассировки.

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

Синтаксис

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

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Attributes

Свойство Description
name Необязательный атрибут.

Указывает имя источника трассировки.
switchName Необязательный атрибут.

Указывает имя экземпляра коммутатора трассировки в приложении. Если переключатель не определен в <switches> элементе, значение указывает уровень для коммутатора.
switchType Необязательный атрибут.

Указывает тип переключателя трассировки. При наличии тип должен быть допустимым именем класса и не может быть пустой строкой.
extraAttribute Необязательный атрибут.

Указывает значение для атрибута трассировки, определяемого методом GetSupportedAttributes для этого источника трассировки.

Дочерние элементы

Элемент Description
<Слушателей> Содержит прослушиватели, которые собирают, хранят и направляют сообщения.

Родительские элементы

Элемент Description
configuration Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями .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>

См. также