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

<Элемент clear> для <прослушивателей> для <источника>

  • Статья

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

См. также раздел