Элемент trace (схема параметров ASP.NET)
Позволяет настраивать службу трассировки кода 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 и управления работой этих приложений. |
Заметки
Когда трассировка включена, каждый запрос страницы создает сообщение трассировки, которое может быть добавлено к выводу страницы или храниться в журнале трассировки приложения. Можно использовать программу просмотра трассировки ASP.NET (Trace.axd) для просмотра отображения журнала трассировки. По умолчанию средство просмотра Trace.axd добавляется к элементу httpHandlers .
.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"
/>
Следующий элемент trace по умолчанию задается в файле 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>
Сведения об элементе
Обработчик раздела конфигурации |
|
Член конфигурации |
|
Настраиваемые расположения |
Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения Файл Web.config уровня виртуального или физического каталога |
Требования |
Microsoft IIS версии 5.0 или более поздней версии Платформа .NET Framework Microsoft Visual Studio |
См. также
Задачи
Практическое руководство. Настройка отдельных каталогов с помощью параметров расположения
Пошаговое руководство. Отключение параметров конфигурации ASP.NET
Ссылки
Элемент system.web (схема параметров ASP.NET)
Элемент configuration (схема общих параметров)
Основные понятия
Общие сведения о трассировке ASP.NET
Иерархия и наследование файла конфигурации ASP.NET
Настройка обеспечения безопасности ASP.NET
Другие ресурсы
Общие параметры конфигурации (ASP.NET)
Параметры конфигурации ASP.NET