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

Статья
11/16/2008

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

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

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

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

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

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

Атрибуты

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

type

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

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

initializeData

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

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

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

Отсутствуют.

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

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