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

Статья
08/11/2011

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

<filter type="System.Diagnostics.EventTypeFilter" 
  initializeData="Warning" />

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

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

Атрибуты

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

type

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

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

initializeData

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

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

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

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

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

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

Заметки

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

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

Пример

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

<configuration>
  <system.diagnostics>
    <sources>
      <source name="myTraceSource" >
        <listeners>
          <add name="console" />
          <remove name="Default" />
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="console" 
        type="System.Diagnostics.ConsoleTraceListener" >
        <filter type="System.Diagnostics.EventTypeFilter" 
          initializeData="Error" />
      </add>
    </sharedListeners>
  </system.diagnostics>
</configuration>