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

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

  • Статья

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

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

Синтаксис

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

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

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

Атрибуты

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

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

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

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

Нет.

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

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

Замечания

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

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

Пример

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

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="myTraceSource" switchName="SourceSwitch"
        switchType="System.Diagnostics.SourceSwitch"  >  
        <listeners>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener" >  
            <filter type="System.Diagnostics.EventTypeFilter"
              initializeData="Error" />  
          </add>  
          <remove name="Default" />  
        </listeners>  
      </source>  
    </sources>  
    <switches>  
      <add name="SourceSwitch" value="Warning" />  
    </switches>  
  </system.diagnostics>  
</configuration>

См. также