<Элемент trace>

Статья
04/11/2023

Содержит прослушиватели, которые собирают, хранят и маршрутизируют сообщения трассировки.

<Конфигурации>
<Системы. диагностика>
<Трассировки>

Синтаксис

<trace autoflush="true|false"
       indentsize="indent value"  
       useGlobalLock="true| false"/>

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

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

Атрибуты

Атрибут	Описание
`autoflush`	Необязательный атрибут. Указывает, будут ли прослушиватели трассировки автоматически очищать выходной буфер после каждой операции записи.
`indentsize`	Необязательный атрибут. Указывает количество пробелов для отступа.
`useGlobalLock`	Необязательный атрибут. Указывает, следует ли использовать глобальную блокировку.

атрибут autoflush

Значение	Описание
`false`	Не очищает выходной буфер автоматически. Это значение по умолчанию.
`true`	Автоматически очищает выходной буфер.

Атрибут useGlobalLock

Значение	Описание
`false`	Не использует глобальную блокировку, если прослушиватель является потокобезопасной; в противном случае использует глобальную блокировку.
`true`	Использует глобальную блокировку независимо от того, является ли прослушиватель потокобезопасной. Это значение по умолчанию.

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

Элемент	Описание
<Слушателей>	Указывает прослушиватель, который собирает, хранит и направляет сообщения.

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

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

Пример

В следующем примере показано, как использовать <trace> элемент для добавления прослушивателя MyListener в коллекцию Listeners . MyListener создает файл с именем MyListener.log и записывает выходные данные в файл. Атрибуту useGlobalLock присваивается значение false, что приводит к тому, что глобальная блокировка не используется, если прослушиватель трассировки является потокобезопасной. Атрибуту autoflush присваивается значение true, что приводит к тому, что прослушиватель трассировки выполняет запись в файл независимо от того, вызывается ли Trace.Flush метод . Атрибут indentsize имеет значение 0 (ноль), что приводит к тому, что при вызове метода прослушиватель будет отступать нулевым пробелом Trace.Indent .

<configuration>  
   <system.diagnostics>  
      <trace useGlobalLock="false" 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" />  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

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