<Добавление> элемента для прослушивателей> для <<источника>

Статья
04/06/2024

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

<configuration>
  <system.diagnostics>
    <sources>
      <source>
        <Слушателей>
          <добавление>

Синтаксис

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

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

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

Атрибуты

Атрибут	Description
`type`	Обязательный атрибут, если вы не ссылаетесь на прослушиватель в `sharedListeners` коллекции, в этом случае необходимо ссылаться только на него по имени (см . пример). Указывает тип прослушивателя. Необходимо использовать строку, которая соответствует требованиям, указанным в указании полных имен типов.
`initializeData`	Необязательный атрибут элемента . Строка, переданная конструктору для указанного класса. Вызывается ConfigurationException , если у класса нет конструктора, который принимает строку.
`name`	Необязательный атрибут элемента . Задает имя прослушивателя.
`traceOutputOptions`	Необязательный атрибут элемента . Указывает TraceOutputOptions значение свойства прослушивателя трассировки.
[настраиваемые атрибуты]	Необязательные атрибуты. Указывает значение атрибутов, определенных прослушивателем, определенным методом GetSupportedAttributes для этого прослушивателя. Delimiter пример дополнительного атрибута, уникального для DelimitedListTraceListener класса.

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

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

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

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

Замечания

Классы прослушивателя, поставляемые с платформа .NET Framework наследуются TraceListener от класса.

Если атрибут прослушивателя трассировки не указан name , Name свойство прослушивателя трассировки по умолчанию использует пустую строку (""). Если у приложения есть только один прослушиватель, его можно добавить без указания имени и удалить его, указав пустую строку для имени. Однако если у приложения несколько прослушивателей, необходимо указать уникальное имя для каждого прослушивателя трассировки, что позволяет определять и управлять отдельными прослушивателями трассировки в TraceSource.Listeners коллекции.

Примечание.

Добавление нескольких прослушивателя трассировки одного типа и с тем же именем приводит только к одному прослушивателю трассировки этого типа и имени, добавляемого в коллекцию Listeners . Однако вы можете программно добавить несколько идентичных прослушивателей в коллекцию Listeners .

Значение атрибута initializeData зависит от типа создаваемого прослушивателя. Не все прослушиватели трассировки требуют указания initializeData.

Примечание.

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

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

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

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

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

Пример

В следующем примере показано, как использовать <add> элементы для добавления прослушивателей console и textListenerListeners коллекции для источника 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>

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