<Add> Element for <sharedListeners>

Статья
04/06/2024

Добавляет прослушиватель в коллекцию sharedListeners. sharedListeners— это коллекция прослушивателей, на которые может ссылаться любой <источник> или <трассировка.> По умолчанию прослушиватели в sharedListeners коллекции не помещаются в Listeners коллекцию. Их необходимо добавить по имени в источник> или <трассировку>.< Невозможно получить прослушиватели в коллекции в sharedListeners коде во время выполнения.

<configuration>
  <system.diagnostics>
    <sharedListeners>
      <добавление>

Синтаксис

<add name="name"
  type="TraceListenerClassName, Version, Culture, PublicKeyToken"  
  initializeData="data"
  traceOutputOptions = "None"
/>

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

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

Атрибуты

Атрибут	Description
`name`	Обязательный атрибут элемента . Указывает имя прослушивателя, который используется для добавления общего прослушивателя в `Listeners` коллекцию.
`type`	Обязательный атрибут элемента . Указывает тип прослушивателя. Необходимо использовать строку, которая соответствует требованиям, указанным в указании полных имен типов.
`initializeData`	Необязательный атрибут элемента . Строка, переданная конструктору для указанного класса.
`traceOutputOptions`	Необязательный атрибут элемента . Строковое представление одного или нескольких TraceOptions элементов перечисления, указывающее, что данные записываются в выходные данные трассировки. Несколько элементов разделены запятыми. Значение по умолчанию — None.

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

Элемент	Description
<filter>	Добавляет фильтр к прослушивателю в коллекции `sharedListeners`.

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

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

Замечания

Классы прослушивателя, поставляемые с платформа .NET Framework наследуются TraceListener от класса. Значение атрибута используется для name добавления общего прослушивателя Listeners в коллекцию для трассировки или источника трассировки. Значение атрибута initializeData зависит от типа создаваемого прослушивателя. Не все прослушиватели трассировки требуют указания initializeData.

Примечание.

При использовании атрибута initializeData можно получить предупреждение компилятора "Атрибут initializeData" не объявлен". Это предупреждение возникает, так как параметры конфигурации проверяются в абстрактном базовом классе TraceListener, который не распознает initializeData атрибут. Как правило, это предупреждение можно игнорировать для реализаций прослушивателя трассировки с конструктором, принимаюющим параметр.

В следующей таблице показаны прослушиватели трассировки, включенные в платформа .NET Framework и описывающие значение их initializeData атрибутов.

Класс прослушивателя трассировки	Значение атрибута initializeData
ConsoleTraceListener	`useErrorStream` Значение конструктораConsoleTraceListener. `initializeData` Задайте атрибуту значение "`true`" для записи трассировки и отладки выходных данных в стандартный поток ошибок; задайте для него значение "`false`" для записи в стандартный выходной поток.
DelimitedListTraceListener	Имя файла, в который DelimitedListTraceListener записывается запись.
System.Diagnostics.EventLogTraceListener	Имя существующего источника журнала событий.
System.Diagnostics.EventSchemaTraceListener	Имя файла, в который EventSchemaTraceListener записывается запись.
System.Diagnostics.TextWriterTraceListener	Имя файла, в который TextWriterTraceListener записывается запись.
XmlWriterTraceListener	Имя файла, в который XmlWriterTraceListener записывается запись.

Файл конфигурации

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

Пример

В следующем примере показано, как использовать <add> элементы для добавления TextWriterTraceListenertextListener в коллекцию sharedListeners . textListener добавляется по имени в коллекцию Listeners для источника TraceSourceAppтрассировки. Прослушиватель textListener записывает выходные данные трассировки в файл myListener.log.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="TraceSourceApp" switchName="sourceSwitch"
        switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener"/>  
          <add name="textListener"/>  
          <remove name="Default"/>  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add name="textListener"
        type="System.Diagnostics.TextWriterTraceListener"
        initializeData="myListener.log"/>  
    </sharedListeners>  
    <switches>  
      <add name="sourceSwitch" value="Warning"/>  
    </switches>  
  </system.diagnostics>  
</configuration>

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