<Элемент 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>

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