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


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

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

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

См. также

Ссылки

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

TraceSource

TraceListener

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

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