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

Статья
11/16/2008

Обновлен: Ноябрь 2007

Очистка коллекции Listeners для трассировки.

Элемент <configuration>
  Элемент <system.diagnostics>
    Элемент <trace>
      Элемент <listeners> для элемента <trace>
        Элемент <clear> для элемента <listeners> для элемента <trace>

<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>