<Элемент trace>

  • Статья

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

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

Синтаксис

<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>

См. также раздел