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

Статья
11/16/2008

Обновлен: Ноябрь 2007

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

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

<system.diagnostics> 
</system.diagnostics>

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

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

Атрибуты

Нет.

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

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

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

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

Пример

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

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

В платформе .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>

См. также

Ссылки

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

Trace

Debug

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