<Элемент clear> для <прослушивателей> для <трассировки>
Очищает коллекцию Listeners
для трассировки.
<Конфигурации>
<Системы. диагностика>
<Трассировки>
<Слушателей>
<Ясно>
Синтаксис
<clear/>
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние и родительские элементы.
Атрибуты
Отсутствует.
Дочерние элементы
Отсутствует.
Родительские элементы
Элемент | Описание |
---|---|
configuration |
Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями .NET Framework. |
system.diagnostics |
Задает прослушиватели трассировки, собирающие, хранящие и маршрутизирующие сообщения, а также уровень, на котором установлен ключ трассировки. |
trace |
Содержит прослушиватели, которые собирают, хранят и маршрутизируют сообщения трассировки. |
listeners |
Содержит прослушиватели, которые собирают, хранят и направляют сообщения. Прослушиватели направляют выходные данные трассировки в соответствующий целевой объект. |
Комментарии
Элемент <clear>
удаляет все прослушиватели из Listeners
коллекции для трассировки. Элемент можно использовать <clear>
перед использованием элемента , <add>
чтобы убедиться, что в коллекции нет других активных прослушивателей.
Вы можете очистить коллекцию Listeners
программным способом, вызвав Clear метод для Trace.Listeners свойства (System.Diagnostics.Trace.Listeners.Clear()
).
Этот элемент можно использовать в файле конфигурации компьютера (Machine.config) и файле конфигурации приложения.
Примечание
Элемент <clear>
удаляет DefaultTraceListener из Listeners
коллекции , изменяя поведение Debug.Assertметодов , Trace.Assert, Debug.Failи Trace.Fail . Assert
Вызов метода или Fail
обычно приводит к отображению окна сообщения. Однако окно сообщения не отображается, если DefaultTraceListener отсутствует в Listeners
коллекции .
Пример
В следующем примере показано, как использовать <clear>
элемент перед использованием <add>
элемента для добавления прослушивателя console
в коллекцию Listeners
для трассировки.
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<clear/>
<add name="console"
type="System.Diagnostics.ConsoleTraceListener" >
<filter type="System.Diagnostics.EventTypeFilter"
initializeData="Error" />
</add>
</listeners>
</trace>
</system.diagnostics>
</configuration>
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по