<элемент source>

  • Статья

Содержит источник трассировки, который инициирует сообщения трассировки.

<Конфигурации>
  <Системы. диагностика>
    <Источников>
      <source>

Синтаксис

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

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

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

Атрибуты

Атрибут Описание
name Необязательный атрибут.

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

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

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

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

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

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

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

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

См. также раздел