Элемент trace (схема параметров ASP.NET)

  • Статья

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

Позволяет настраивать службу трассировки кода ASP.NET, которая управляет сбором, хранением и выводом результатов трассировки.

Элемент configuration (схема общих параметров)
  Элемент system.web (схема параметров ASP.NET)
    Элемент trace (схема параметров ASP.NET)

<trace 
   enabled="true|false"
   localOnly="true|false"
   pageOutput="true|false"
   requestLimit="integer" 
   mostRecent="true|false"
   writeToDiagnosticsTrace="true|false"
   traceMode="SortByTime|SortByCategory"
/>

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

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

Атрибуты

Атрибут

Описание

enabled

Необязательный атрибут Boolean.

Определяет, включена ли трассировка для приложения. Чтобы использовать средство просмотра Trace.axd, трассировка должна быть включена. По умолчанию средство просмотра Trace.axd добавляется к элементу httpHandlers .

Значение по умолчанию: false.

localOnly

Необязательный атрибут Boolean.

Указывает, что средство просмотра трассировки (Trace.axd) доступно только на веб-сервере, который является хостом. При значении false средство просмотра доступно с любого компьютера. По умолчанию средство просмотра Trace.axd добавляется к элементу httpHandlers .

Значение по умолчанию — true.

mostRecent

Необязательный атрибут Boolean.

Указывает, будут ли отображаться самые последние данные трассировки уровня приложения и удаляться предыдущие данные трассировки, выходящие за указанные границы requestLimit. При значении false данные трассировки по запросам будут отображаться до достижения значения атрибута requestLimit .

Этот атрибут не использовался до .NET Framework версии 2.0.

Значение по умолчанию — false.

pageOutput

Необязательный атрибут Boolean.

Определяет, отображаются ли выходные данные трассировки в конце каждой страницы. При значении false данные трассировки доступны только из утилиты трассировки.

Значение по умолчанию — false.

requestLimit

Необязательный атрибут Int32.

Задает число хранимых на сервере запросов трассировки. Когда атрибут mostRecent имеет значение false и достигается граничное значение, трассировка автоматически отключается.

Максимальное количество запросов — 10 000. Если значение больше 10 000, ASP.NET уменьшает его до 10 000 автоматически.

Значение по умолчанию — 10.

traceMode

Необязательный атрибут TraceDisplayMode.

Определяет порядок вывода сведений трассировки.

Атрибут traceMode может принимать одно из следующих значений.

Значение Описание
SortByCategory Задает отображение данных трассировки в алфавитном порядке по категории, определяемой пользователем.
SortByTime Задает отображение данных трассировки в том порядке, в котором они обрабатывались.

Значение по умолчанию — SortByTime.

writeToDiagnosticsTrace

Необязательный атрибут Boolean.

Указывает, что сообщения трассировки ASP.NET направляются в инфраструктуру трассировки System.Diagnostics для любых прослушивателей, которые зарегистрированы для отображения сообщений Trace. Дополнительные сведения см. в описании элемента trace элемента system.diagnostics.

Этот атрибут не использовался до .NET Framework версии 2.0.

Значение по умолчанию — false.

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

Нет.

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

Элемент

Описание

configuration

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

system.web

Указывает корневой элемент для параметров конфигурации ASP.NET в файле конфигурации и содержит элементы конфигурации для настройки веб-приложений ASP.NET и управления поведением этих приложений.

Заметки

Элемент trace позволяет настраивать службу трассировки кода ASP.NET, которая управляет сбором, хранением и отображением результатов трассировки.

Если трассировка включена, то для каждой страницы запроса создаются сообщения трассировки, которые могут добавляться к выводу страницы или могут храниться в журнале трассировки приложения. Для просмотра содержимого журнала трассировки можно использовать средство просмотра трассировки ASP.NET (Trace.axd) . По умолчанию средство просмотра Trace.axd добавляется к элементу httpHandlers .

6915t83k.alert_note(ru-ru,VS.90).gifПримечание.

Как правило, не следует включать трассировку на действующем веб-узле, так как при этом любой, кто просматривает страницы, может получить закрытые данные о конфигурации веб-узла. Трассировка используется только для отладки. Если атрибутlocalOnly имеет значение true, то результаты трассировки можно просмотреть только по запросам с локального хоста (localhost). Кроме того, если в файле Web.config задан параметр <deployment retail=true>, то трассировка отключена.

Для инструментирования готовых построений можно использовать свойства и методы класса Trace. Инструментирование позволяет отслеживать состояние приложения в реальных условиях. С помощью трассировки можно выделять проблемы и устранять их, не прерывая работу системы.

Чтобы включить трассировку, необходимо перекомпилировать приложение с установленным флагом трассировки. Для этого в строке конфигурации для языкового компилятора, который должен поддерживать трассировку, нужно установить атрибут compilerOptions в значение ="/d:TRACE". См. раздел Элемент <compiler>

Конфигурация по умолчанию

Следующий элемент по умолчанию trace не задается явно в файле Machine.config или в корневом файле Web.config. Однако это конфигурация по умолчанию, которая возвращается приложением в .NET Framework 2.0.

<trace 
   enabled="false" 
   localOnly="true" 
   mostRecent="false" 
   pageOutput="false" 
   requestLimit="10" 
   traceMode="SortByTime" 
   writeToDiagnosticsTrace="false" 
/>

Следующий элемент по умолчанию element задается в файле Machine.config для платформы .NET Framework версий 1.0 и 1.1.

<trace
   enabled="false"
   localOnly="true"
   pageOutput="false"
   requestLimit="10"
   traceMode="SortByTime"
/>

Пример

В следующем примере демонстрируется задание параметров конфигурации для трассировки.

<configuration>
  <system.web>
    <trace enabled="true" 
      pageOutput="true"
      requestLimit="15"
      mostRecent="true" />
    <system.web>
</configuration>

Сведения об элементе

Обработчик раздела конфигурации

TraceSection

Элемент конфигурации

TraceSection

Настраиваемые расположения

Machine.config

Файл Web.config корневого уровня

Файл Web.config уровня приложения

Файл Web.config уровня виртуального или физического каталога

Требования

Microsoft IIS версии 5.0, 5.1 или 6.0

.NET Framework версии 1.0, 1.1 или 2.0

Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

Задачи

Практическое руководство. Просмотр сведений о трассировке ASP.NET c помощью средства просмотра трассировки

Практическое руководство. Настройка отдельных каталогов с помощью параметров расположения

Пошаговое руководство. Отключение параметров конфигурации ASP.NET

Основные понятия

Общие сведения о трассировке ASP.NET

Иерархия и наследование файла конфигурации ASP.NET

Настройка обеспечения безопасности ASP.NET

Сценарии конфигурации ASP.NET

Ссылки

Элемент system.web (схема параметров ASP.NET)

Элемент configuration (схема общих параметров)

Элемент <trace>

System.Configuration

System.Web.Configuration

TraceSection

Trace

Другие ресурсы

Общие параметры конфигурации (ASP.NET)

Параметры конфигурации ASP.NET

Администрирование веб-узлов ASP.NET

Конфигурационный интерфейс API ASP.NET