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

Статья
04/06/2024

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

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

Синтаксис

<add name="name"
     type="trace listener class name, Version, Culture, PublicKeyToken"  
     initializeData="data"/>

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

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

Атрибуты

Атрибут	Описание
type	Обязательный атрибут элемента . Указывает тип прослушивателя. Необходимо использовать строку, которая соответствует требованиям, указанным в указании полных имен типов.
initializeData	Необязательный атрибут элемента . Строка, переданная конструктору для указанного класса.
name	Необязательный атрибут элемента . Задает имя прослушивателя.

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

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

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

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

Замечания

Классы Debug используют одну и ту же коллекцию прослушивателей.Trace При добавлении объекта прослушивателя в коллекцию в одном из этих классов другой класс использует тот же прослушиватель. Классы прослушивателя являются производными от TraceListener.

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

Примечание.

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

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

Примечание.

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

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

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

Пример

В следующем примере показано, как добавлять <элементы для добавления> прослушивателей и MyEventListener в коллекцию прослушивателейMyListener. MyListener создает файл с именем MyListener.log и записывает выходные данные в файл. MyEventListener создает запись в журнале событий.

<configuration>  
   <system.diagnostics>  
      <trace autoflush="true" indentsize="0">  
         <listeners>  
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />  
            <add name="MyEventListener"  
                 type="System.Diagnostics.EventLogTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"                 initializeData="MyConfigEventLog"/>  
            <add name="configConsoleListener"  
                 type="System.Diagnostics.ConsoleTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

Share via