<Элемент listeners> для <трассировки>

  • Статья

Указывает прослушиватель, который собирает, хранит и направляет сообщения. Прослушиватели направляют выходные данные трассировки в соответствующий целевой объект.

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

Синтаксис

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

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

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

Атрибуты

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

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

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

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

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

Комментарии

Классы Debug и Trace совместно используют одну коллекцию Прослушивателей . При добавлении объекта прослушивателя в коллекцию в одном из этих классов другой класс использует тот же прослушиватель. Классы прослушивателя, поставляемые с платформа .NET Framework производными TraceListener от класса .

Файл конфигурации

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

Пример

В следующем примере показано, как использовать <элемент listeners> для добавления прослушивателей MyListener и MyEventListener в коллекцию Listeners . MyListener создает файл с именем MyListener.log и записывает выходные данные в файл . MyEventListener создает запись в журнале событий.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="true" indentsize="0">  
      <listeners>  
        <add name="myListener"
          type="System.Diagnostics.TextWriterTraceListener,
            system, version=1.0.3300.0, Culture=neutral,
            PublicKeyToken=b77a5c561934e089"
          initializeData="c:\myListener.log" />  
        <add name="MyEventListener"  
          type="System.Diagnostics.EventLogTraceListener,
            system, version=1.0.3300.0, Culture=neutral,
            PublicKeyToken=b77a5c561934e089"  
          initializeData="MyConfigEventLog"/>  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>

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