<Элемент sharedListeners>

  • Статья

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

<Конфигурации>
  <Системы. диагностика>
    <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 . Прослушиватель трассировки консоли записывает сведения трассировки в консоль с помощью вызовов или TraceSourceTrace.

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

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