Элемент <source>

Статья
08/11/2011

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

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

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

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

Атрибуты

Атрибут	Описание
name	Необязательный атрибут. Задает имя источника трассировки.
switchName	Необязательный атрибут. Задает имя экземпляра переключателя трассировки в приложении. Если переключатель не идентифицирован в элементе <switches>, это значение задает уровень для переключателя.
switchType	Необязательный атрибут. Задает тип переключателя трассировки. Если этот атрибут указан, тип должен представлять собой действительное имя класса и не может быть пустой строкой.
extraAttribute	Необязательный атрибут. Задает значение атрибута конкретного источника трассировки, идентифицируемого методом GetSupportedAttributes данного источника.

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

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

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

Элемент	Описание
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>

См. также

Ссылки

Схема параметров трассировки и отладки

Основные понятия

Trace Sources

Переключатели трассировки

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