<trace> Элемент

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

<configuration>   <system.diagnostics>     <trace>

Синтаксис

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

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

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

Attributes

Свойство Description
autoflush Необязательный атрибут.

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

Указывает количество пробелов для отступа.
useGlobalLock Необязательный атрибут.

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

Атрибут autoflush

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

атрибут useGlobalLock

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

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

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

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

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

Example

В следующем примере показано, как использовать <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>

См. также

  • Last updated on