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

Статья
08/11/2011

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

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