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


<system.diagnostics> Элемент

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

<configuration>   <system.diagnostics>

Синтаксис

<system.diagnostics>
</system.diagnostics>

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

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

Attributes

Нет.

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

Элемент Description
<утверждать> Указывает, следует ли отображать поле сообщения при вызове Debug.Assert метода; также указывает имя файла для записи сообщений.
<performanceCounters> Задает размер глобальной памяти, к которой используется счетчики производительности.
<sharedListeners> Содержит прослушиватели, на которые может ссылаться любой исходный элемент или элемент трассировки. Прослушиватели, определенные как общие прослушиватели, можно добавлять в источники или трассировки по имени.
<Источников> Указывает источники трассировки, инициирующие сообщения трассировки.
<Переключатели> Содержит переключатели трассировки и уровни, на которых заданы коммутаторы трассировки.
<след> Содержит прослушиватели, которые собирают, хранят и маршрутизирует сообщения трассировки.

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

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

Example

В следующем примере показано, как внедрить переключатель трассировки и прослушиватель трассировки внутри <system.diagnostics> элемента. Для General параметра трассировки задан TraceLevel уровень. Прослушиватель myListener трассировки создает файл с именем MyListener.log и записывает выходные данные в файл.

Замечание

В .NET Framework версии 2.0 можно использовать текст, чтобы указать значение для коммутатора. Например, можно указать true или BooleanSwitch использовать текст, представляющий значение перечисления, Error например для объекта TraceSwitch. Строка <add name="myTraceSwitch" value="Error" /> эквивалентна <add name="myTraceSwitch" value="1" />.

<configuration>
   <system.diagnostics>
      <switches>
         <add name="General" value="4" />
      </switches>
      <trace autoflush="true" indentsize="2">
         <listeners>
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="MyListener.log" traceOutputOptions="ProcessId, LogicalOperationStack, Timestamp, ThreadId, Callstack, DateTime" />
         </listeners>
      </trace>
   </system.diagnostics>
</configuration>

См. также