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


Элемент <trace>

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

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

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

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

Атрибуты

Атрибут

Описание

autoflush

Необязательный атрибут.

Указание того, должны ли прослушиватели трассировки автоматически очищать выходной буфер после каждой операции записи.

indentsize

Необязательный атрибут.

Задание количества пробелов для отступа.

useGlobalLock

Необязательный атрибут.

Определение того, необходимо ли использовать глобальную блокировку.

Атрибут autoflush

Значение

Описание

false

Автоматическая очистка выходного буфера не выполняется. Это значение по умолчанию.

true

Выполняется автоматическая очистка выходного буфера.

Атрибут useGlobalLock

Значение

Описание

false

Глобальная блокировка не используется, если прослушиватель потокобезопасен; в противном случае глобальная блокировка используется.

true

Глобальная блокировка используется независимо от того, является ли прослушиватель потокобезопасным. Это значение по умолчанию.

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

Элемент

Описание

<listeners>

Задает прослушиватель, собирающий, хранящий и маршрутизирующий сообщения.

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

Элемент

Описание

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>

См. также

Ссылки

Схема параметров трассировки и отладки

TraceListener

DefaultTraceListener

TextWriterTraceListener

EventLogTraceListener