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

Статья
11/16/2008

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

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

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

<clear/>

Атрибуты и элементы

В следующих разделах описываются атрибуты, дочерние и родительские элементы.

Атрибуты

Отсутствуют.

Дочерние элементы

Отсутствуют.

Родительские элементы

Элемент	Описание
configuration	Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями .NET Framework.
system.diagnostics	Элемент, задающий прослушиватели трассировки, предназначенные для сбора, хранения и маршрутизации сообщений, а также уровень, на котором установлен переключатель трассировки.
sources	Содержит источники трассировки, от которых исходят трассировочные сообщения.
source	Задает источник трассировки, от которого исходят сообщения трассировки.
listeners	Задает прослушиватели, предназначенные для сбора, хранения и маршрутизации сообщений.

Заметки

Элемент <clear> удаляет всех прослушивателей из коллекции Listeners источника трассировки, включая DefaultTraceListener. Элемент <clear> можно использовать перед элементом <add>, чтобы убедиться в том, что в коллекции отсутствуют другие активные прослушиватели.

Файл конфигурации

Этот элемент может быть использован в файле конфигурации компьютера (Machine.config) и в файле конфигурации приложения.

Пример

В следующем примере показано, как использовать элемент <clear> перед элементами <add>, чтобы добавить прослушиватели console и textListener к коллекции Listeners источника трассировки TraceSourceApp.

<configuration>
  <system.diagnostics>
    <sources>
       <source name="TraceSourceApp" switchName="sourceSwitch" 
         switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <clear/>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener"/>
          <add name="textListener"/>
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="textListener" 
        type="System.Diagnostics.TextWriterTraceListener" 
        initializeData="myListener.log"/>
    </sharedListeners>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration>