Элемент <listeners>

Статья
08/11/2011

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

<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

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

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

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