<Элемент sharedListeners>

Статья
04/11/2023

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

<Конфигурации>
<Системы. диагностика>
<sharedListeners>

Синтаксис

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

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

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

Атрибуты

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

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

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

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