Элемент <listeners> для <trace>

Статья
08/11/2011

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

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

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

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

Атрибуты

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

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

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

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

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

Заметки

Классы Debug и Trace совместно используют коллекцию Listeners. Если в одном из этих классов в коллекцию добавляется объект прослушивателя, то этот прослушиватель используется и в другом классе. Классы прослушивателей, поставляемые с платформой .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>

См. также

Ссылки

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

TraceListener

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