Элемент <trace>

Статья
08/11/2011

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

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

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

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

Атрибуты

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

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>