Share via

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

  • Статья

Добавляет фильтр в прослушиватель в Listeners коллекцию для трассировки.

<configuration>
  <system.diagnostics>
    <trace>
      <Слушателей>
        <добавление>
          <filter>

Синтаксис

<filter
  type="traceFilterClassName"
  initializeData="data" />

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

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

Атрибуты

Атрибут Description
type Обязательный атрибут элемента .

Указывает тип фильтра, который должен наследоваться от TraceFilter класса. Можно использовать полное имя типа, соответствующего свойству типа, или использовать полное имя типа, FullName включая сведения о сборке, соответствующие свойству AssemblyQualifiedName . Сведения о полных именах типов см. в разделе "Указание полных имен типов".
initializeData Необязательный атрибут элемента .

Строка, переданная конструктору для указанного класса фильтра.

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

Нет.

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

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

Замечания

Элемент <filter> должен содержаться в <add> элементе прослушивателя трассировки, указывающего тип прослушивателя, а не только имя прослушивателя, определенного в <sharedListeners>. Если прослушиватель определен в <sharedListeners>, фильтр для этого прослушивателя должен быть определен в этом элементе.

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

Пример

В следующем примере показано, как использовать <filter> элемент для добавления фильтра в прослушиватель console в Listeners коллекцию для трассировки, указав уровень события фильтра как Error.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="console"
          type="System.Diagnostics.ConsoleTraceListener" >  
          <filter type="System.Diagnostics.EventTypeFilter"
            initializeData="Error" />  
        </add>  
        <remove name="Default" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>

См. также