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

  • Статья

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

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

Синтаксис

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

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

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

Атрибуты

Отсутствует.

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

Элемент Описание
<добавление> Добавляет прослушиватель в коллекцию Listeners.
<Удалить> Удаляет прослушиватель из Listeners коллекции.
<Ясно> Очищает коллекцию 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>

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