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

Статья
08/11/2011

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

<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

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