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


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

Очищает коллекцию 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> 

См. также

Ссылки

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

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

Listeners

Trace

Debug

TraceSource

Основные понятия

Прослушиватели трассировки