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

Статья
11/16/2008

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

Удаляет прослушиватель из коллекции Listeners для источника трассировки.

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

<remove name="listenerName" />

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

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

Атрибуты

Атрибут	Описание
name	Обязательный атрибут. Имя прослушивателя для удаления из коллекции Listeners.

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

Нет.

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

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

Заметки

Элемент <remove> удаляет указанный прослушиватель из коллекции Listeners для источника трассировки.

Можно удалить элемент из коллекции Listeners для источника трассировки программными средствами, вызвав метод Remove для свойства Listeners экземпляра TraceSource.

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

Пример

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

<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceSourceApp" switchName="sourceSwitch" 
         switchType="System.Diagnostics.SourceSwitch" >
         <listeners>
           <remove name="Default"/>
           <add name="console" 
             type="System.Diagnostics.ConsoleTraceListener" />
         </listeners>
      </source>
    </sources>
  </system.diagnostics>
</configuration>