Элемент <filter> для элемента <add> для элемента <listeners> для элемента <trace>

Статья
11/16/2008

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

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

Элемент <configuration>
  Элемент <system.diagnostics>
    Элемент <trace>
      Элемент <listeners> для элемента <trace>
        Элемент <add> для элемента <listeners> для элемента <trace>
          Элемент <filter> для элемента <add> для элемента <listeners> для элемента <trace>

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

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

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

Атрибуты

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

type

Обязательный атрибут.

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

initializeData

Необязательный атрибут.

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

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

Отсутствует.

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

Элемент	Описание
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>