Элемент <sharedListeners>

Статья
11/16/2008

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

Содержит прослушиватели, на которые может ссылаться любой источник или элемент трассировки. По умолчанию эти прослушиватели не принимают никакой трассировки, и извлечь эти прослушиватели во время выполнения невозможно. Прослушиватели, определенные как общие, могут добавляться к источникам или трассировкам по имени.

Элемент <configuration>
Элемент <system.diagnostics>
Элемент <sharedListeners>

<sharedListeners> 
  <add>...</add>
</sharedListeners>

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

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

Атрибуты

Нет.

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

Элемент	Описание
Элемент <add> для элемента <listeners> для элемента <trace>	Добавляет прослушиватель в коллекцию sharedListeners.

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

Элемент	Описание
Configuration	Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями платформы .NET Framework.
system.diagnostics	Определяет корневой элемент для раздела конфигурации ASP.NET.

Заметки

Добавление прослушивателя в коллекцию общих прослушивателей не делает его активным. Его по-прежнему необходимо добавить к источнику трассировки или трассировке, добавив его в коллекцию Listeners соответствующего элемента трассировки. Классы слушателей платформы .NET Framework являются производными от класса TraceListener.

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

Пример

В следующем примере показано, как использовать <sharedListeners> для добавления прослушивателя console в коллекцию Listeners для классов TraceSource и Trace. Прослушиватель трассировки консоли выводит трассировочную информацию на консоль путем вызова методов TraceSource или Trace.

<system.diagnostics>
  <sources>
    <source name="mySource" switchName="sourceSwitch value="Verbose" >
      <listeners>
        <add name="console" />
      </listeners>
    </source>
  </sources>  
  <sharedListeners>    <add name="console" type="System.Diagnostics.ConsoleTraceListener" >      <filter type="System.Diagnostics.EventTypeFilter"         initializeData="Warning" />    </add>  </sharedListeners>
  <trace>
    <listeners>
      <add name="console" />
    </listeners>
  </trace>
</system.diagnostics>

См. также

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

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

Ссылки

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

TraceListener

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