Элемент <listeners> для элемента <source>

Статья
11/16/2008

Обновлен: Ноябрь 2007

Добавление или удаление прослушивателей в коллекции Listeners для свойства TraceSource. Прослушиватель направляет данные трассировки соответствующему целевому объекту, например в журнал событий, окно или текстовый файл.

Элемент <configuration>
  Элемент <system.diagnostics>
    Элемент <sources>
      Элемент <source>
        Элемент <listeners> для элемента <source>

<listeners> 
  <add>...</add>
  <remove ... />
  <clear/>
</listeners>

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

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

Атрибуты

Нет.

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

Элемент	Описание
Элемент <add> для элемента <listeners> для элемента <source>	Добавление прослушивателя в коллекцию Listeners.
Элемент <remove> для элемента <listeners> для элемента <source>	Удаление прослушивателя из коллекции Listeners.
Элемент <clear> для элемента <listeners> для элемента <source>	Удаление коллекции Listeners для источника трассировки.

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

Элемент	Описание
configuration	Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями .NET Framework.
system.diagnostics	Элемент, задающий прослушиватели трассировки, предназначенные для сбора, хранения и маршрутизации сообщений, а также уровень, на котором установлен переключатель трассировки.
sources	Элемент, содержащий источники трассировки, инициирующие трассировочные сообщения.
source	Источник трассировки, инициирующий сообщения трассировки.

Заметки

Файл конфигурации

Этот элемент может быть использован в файле конфигурации компьютера (Machine.config) и в файле конфигурации приложения.

Пример

В следующем примере кода показано, как с помощью элемента <listeners> добавить прослушиватель трассировки консоли в источник mySource и удалить прослушиватель трассировки по умолчанию.

<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>

См. также

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

Прослушиватели трассировки

Ссылки

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

TraceListener

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