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

Статья
08/11/2011

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