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

Статья
08/11/2011

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

<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>