Элемент <sharedListeners>

Статья
08/11/2011

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

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

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

См. также

Ссылки

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

TraceListener

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

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

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