Элемент <listeners> для <trace>
Задает прослушиватель, собирающий, хранящий и маршрутизирующий сообщения. Прослушиватели направляют выходные данные трассировки соответствующему целевому объекту.
<listeners>
<add>...</add>
<clear/>
<remove ... />
</listeners>
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние и родительские элементы.
Атрибуты
Отсутствует.
Дочерние элементы
Элемент |
Описание |
---|---|
Добавляет прослушиватель в коллекцию Listeners. |
|
Очищает коллекцию Listeners для трассировки. |
|
Удаляет прослушиватель из коллекции 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>