Элемент <clear> для элемента <listeners> для элемента <source>
Обновлен: Ноябрь 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>