ASP <asp>
Общие сведения
Элемент <asp> задает параметры конфигурации для приложения ASP. К ним относятся параметры конфигурации, ориентированные на разработчика, такие как атрибуты, управляющие параметрами отладки и возврата ошибок. Элемент <asp> также включает атрибуты, управляющие кодировкой, используемой приложением, языком сценариев для приложения и включением журнала ошибок для приложения.
Элемент <asp> также может содержать элементы, которые настраивают COM+, кэширование ASP, ограничения буферизации и состояние сеанса для сайта или приложения.
Совместимость
| Версия | Примечания |
|---|---|
| IIS 10.0 | Элемент <asp> не был изменен в IIS 10.0. |
| IIS 8,5 | Элемент <asp> не был изменен в IIS 8.5. |
| IIS 8,0 | Элемент <asp> не был изменен в IIS 8.0. |
| IIS 7,5 | Элемент <asp> не был изменен в IIS 7.5. |
| IIS 7.0 | Элемент <asp> появился в IIS 7.0. |
| IIS 6,0 | Элемент <asp> и его дочерние элементы заменяют свойства, связанные с ASP, в объекте IIS 6.0 IIsWebService . |
Настройка
Для поддержки и настройки приложений ASP на веб-сервере необходимо установить модуль ASP. Чтобы установить модуль ASP, выполните следующие действия.
Windows Server 2012 или Windows Server 2012 R2
- На панели задач щелкните Диспетчер сервера.
- В диспетчер сервера откройте меню Управление и выберите пункт Добавить роли и компоненты.
- В мастере добавления ролей и компонентов нажмите кнопку Далее. Выберите тип установки и нажмите кнопку Далее. Выберите целевой сервер и нажмите кнопку Далее.
- На странице Роли сервера разверните узел Веб-сервер (IIS),веб-сервер, узел Разработка приложений, а затем выберите ASP.
- Если появится диалоговое окно Добавление компонентов, необходимых для ASP? , нажмите кнопку Добавить компоненты. (Эта страница отображается только в том случае, если вы еще не установили службу роли расширений ISAPI на сервере.)
- На странице Роли сервера нажмите кнопку Далее.
- На странице Выбор компонентов нажмите кнопку Далее.
- На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
- На странице Результаты нажмите кнопку Закрыть.
Windows 8 или Windows 8.1
На начальном экране переместите указатель в левый нижний угол, щелкните правой кнопкой мыши кнопку Пуск и выберите пункт панель управления.
В панель управления щелкните Программы и компоненты, а затем — Включить или выключить компоненты Windows.
Разверните узлы Службы IIS, Службы Интернета, Компоненты разработки приложений, а затем выберите ASP.
Примечание
Роль расширения ISAPI будет выбрана, если она еще не установлена.
Нажмите кнопку ОК.
Щелкните Закрыть.
Windows Server 2008 или Windows Server 2008 R2
- На панели задач нажмите кнопку Пуск, наведите указатель мыши на пункт Администрирование, а затем щелкните диспетчер сервера.
- В области иерархии диспетчер сервера разверните узел Роли, а затем щелкните Веб-сервер (IIS) .
- В области Веб-сервер (IIS) прокрутите страницу до раздела Службы ролей и щелкните Добавить службы ролей.
- На странице Выбор служб ролеймастера добавления служб ролей выберите ASP.
- Если появится диалоговое окно Добавление служб ролей, необходимых для ASP , щелкните Добавить необходимые службы ролей. (Эта страница отображается только в том случае, если вы еще не установили службу роли расширений ISAPI на сервере.)
- На странице Выбор служб ролей нажмите кнопку Далее.
- На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
- На странице Результаты нажмите кнопку Закрыть.
Windows Vista или Windows 7
- На панели задач нажмите кнопку Пуск, а затем выберите пункт панель управления.
- В панель управления щелкните Программы и компоненты, а затем — Включить или отключить компоненты Windows.
- Разверните узел Службы IIS, Затем — Службы Интернета, а затем Функции разработки приложений.
- Выберите ASP и нажмите кнопку ОК.
Инструкции
Настройка параметров ASP для сайта или приложения
Откройте диспетчер служб IIS.
Если вы используете Windows Server 2012 или Windows Server 2012 R2:
- На панели задач щелкните диспетчер сервера, инструменты, а затем диспетчер служб IIS.
Если вы используете Windows 8 или Windows 8.1:
- Удерживая нажатой клавишу Windows, нажмите букву X и щелкните панель управления.
- Щелкните Администрирование, а затем дважды щелкните диспетчер служб IIS.
Если вы используете Windows Server 2008 или Windows Server 2008 R2:
- На панели задач нажмите кнопку Пуск, наведите указатель на пункт Администрирование, а затем щелкните Диспетчер служб IIS.
Если вы используете Windows Vista или Windows 7:
- На панели задач нажмите кнопку Пуск, а затем выберите пункт панель управления.
- Дважды щелкните элемент Администрирование, а затем дважды щелкните диспетчер служб IIS.
В области Подключения разверните имя сервера, узел Сайты, а затем перейдите к веб-сайту или веб-приложению, которые требуется настроить.
На домашней панели сайта или приложения дважды щелкните ЭЛЕМЕНТ ASP.
В области ASP настройте необходимые параметры и нажмите кнопку Применить на панели Действия .
Конфигурация
Элемент можно настроить <asp> на уровне сервера в файле ApplicationHost.config. Однако по умолчанию невозможно настроить <asp> элемент на уровне сайта или приложения.
Атрибуты
| Атрибут | Описание |
|---|---|
appAllowClientDebug |
Дополнительный логический атрибут. Указывает, включена ли отладка на стороне клиента. Значение по умолчанию — false. |
appAllowDebugging |
Дополнительный логический атрибут. Указывает, включена ли отладка на стороне сервера. Значение по умолчанию — false. |
bufferingOn |
Дополнительный логический атрибут. Указывает, включена ли буферизация выходных данных приложения ASP. Значение по умолчанию — true. |
calcLineNumber |
Дополнительный логический атрибут. Указывает, будет ли ASP вычислять и хранить номер строки каждой выполненной строки кода, чтобы предоставить номер в отчете об ошибках. Значение по умолчанию — true. |
codePage |
Необязательный атрибут uint. Задает кодировку по умолчанию для приложения ASP. Это значение является целым числом в диапазоне от 0 до 2147483647. Например, значение 1252 задает для набора символов по умолчанию латинскую кодировку, используемую в американском английском и многих европейских алфавитах. Значение по умолчанию — 0. |
enableApplicationRestart |
Дополнительный логический атрибут. Указывает, будут ли приложения ASP автоматически перезапускаться при каждом изменении параметра конфигурации. Значение по умолчанию — true. |
enableAspHtmlFallback |
Дополнительный логический атрибут. Указывает, будет ли .htm файл с тем же именем, что и запрошенный ASP-файл, если он существует, отправляться клиенту вместо ASP-файла. Это произойдет в случае, если запрос будет отклонен из-за полной очереди запроса. Значение по умолчанию — true. |
enableChunkedEncoding |
Дополнительный логический атрибут. Указывает, включено ли кодирование фрагмента передачи HTTP 1.1. Значение по умолчанию — true. |
enableParentPaths |
Дополнительный логический атрибут. Указывает, разрешены ли страницы ASP пути относительно текущего каталога или выше текущего каталога. Значение по умолчанию — false. |
errorsToNTLog |
Дополнительный логический атрибут. Указывает, включена ли регистрация ошибок ASP в журнале событий Windows. Значение по умолчанию — false. |
exceptionCatchEnable |
Дополнительный логический атрибут. Указывает, включено ли перехват исключений компонента COM. Если задано значение false, средство Microsoft Script Debugger не перехватывает исключения, отправленные отлаживаемым компонентом. Значение по умолчанию — true. |
lcid |
Необязательный атрибут uint. Задает идентификатор языкового стандарта по умолчанию для приложения ASP. Это значение является целым числом в диапазоне от 0 до 2147483647. Значение по умолчанию — 0. |
logErrorRequests |
Дополнительный логический атрибут. Указывает, записываются ли ошибки ASP в клиентский браузер и журналы IIS по умолчанию. Значение по умолчанию — true. |
runOnEndAnonymously |
Дополнительный логический атрибут. Указывает, выполняются ли глобальные функции ASP SessionOnEnd и ApplicationOnEnd от имени анонимного пользователя. Значение по умолчанию — true. |
scriptErrorMessage |
Необязательный строковый атрибут. Указывает сообщение об ошибке, которое будет отправлено в браузер, если определенные ошибки отладки не отправляются клиенту. Значение по умолчанию — An error occurred on the server when processing the URL. Please contact the system administrator. |
scriptErrorSentToBrowser |
Дополнительный логический атрибут. Указывает, включена ли запись отладчика в клиентский браузер. Значение по умолчанию — false. |
scriptLanguage |
Необязательный строковый атрибут. Задает язык скриптов по умолчанию для всех приложений ASP, работающих на веб-сервере. Значение по умолчанию — VBScript. |
Дочерние элементы
| Элемент | Описание |
|---|---|
cache |
Необязательный элемент. Задает параметры кэша ASP. |
comPlus |
Необязательный элемент. Задает параметры COM+. |
limits |
Необязательный элемент. Задает ограничения для различных свойств ASP. |
session |
Необязательный элемент. Задает параметры состояния сеанса ASP. |
Образец конфигурации
Следующий пример конфигурации включает буферизацию и состояние сеанса для приложений ASP на сайте Contoso и отключает родительские пути для этого же сайта.
<location path="Contoso">
<system.webServer>
<asp enableParentPaths="false" bufferingOn="true">
<session allowSessionState="true" />
</asp>
</system.webServer>
</location>
Пример кода
В следующих примерах кода включается буферизация и состояние сеанса для приложений ASP на сайте Contoso и отключение родительских путей для этого сайта.
AppCmd.exe
appcmd.exe set config "Contoso" -section:system.webServer/asp /enableParentPaths:"False" /commit:apphost
appcmd.exe set config "Contoso" -section:system.webServer/asp /bufferingOn:"True" /commit:apphost
appcmd.exe set config "Contoso" -section:system.webServer/asp /session.allowSessionState:"True" /commit:apphost
Примечание
При использовании AppCmd.exe для настройки этих параметров для параметра apphostфиксации необходимо задать значение . Это зафиксирует параметры конфигурации в соответствующем разделе расположения в файле ApplicationHost.config.
C#
using System;
using System.Text;
using Microsoft.Web.Administration;
internal static class Sample
{
private static void Main()
{
using (ServerManager serverManager = new ServerManager())
{
Configuration config = serverManager.GetApplicationHostConfiguration();
ConfigurationSection aspSection = config.GetSection("system.webServer/asp", "Contoso");
aspSection["enableParentPaths"] = false;
aspSection["bufferingOn"] = true;
ConfigurationElement sessionElement = aspSection.GetChildElement("session");
sessionElement["allowSessionState"] = true;
serverManager.CommitChanges();
}
}
}
VB.NET
Imports System
Imports System.Text
Imports Microsoft.Web.Administration
Module Sample
Sub Main()
Dim serverManager As ServerManager = New ServerManager
Dim config As Configuration = serverManager.GetApplicationHostConfiguration
Dim aspSection As ConfigurationSection = config.GetSection("system.webServer/asp", "Contoso")
aspSection("enableParentPaths") = False
aspSection("bufferingOn") = True
Dim sessionElement As ConfigurationElement = aspSection.GetChildElement("session")
sessionElement("allowSessionState") = True
serverManager.CommitChanges()
End Sub
End Module
JavaScript
var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var aspSection = adminManager.GetAdminSection("system.webServer/asp", "MACHINE/WEBROOT/APPHOST/Contoso");
aspSection.Properties.Item("enableParentPaths").Value = false;
aspSection.Properties.Item("bufferingOn").Value = true;
var sessionElement = aspSection.ChildElements.Item("session");
sessionElement.Properties.Item("allowSessionState").Value = true;
adminManager.CommitChanges();
VBScript
Set adminManager = CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set aspSection = adminManager.GetAdminSection("system.webServer/asp", "MACHINE/WEBROOT/APPHOST/Contoso")
aspSection.Properties.Item("enableParentPaths").Value = False
aspSection.Properties.Item("bufferingOn").Value = True
Set sessionElement = aspSection.ChildElements.Item("session")
sessionElement.Properties.Item("allowSessionState").Value = True
adminManager.CommitChanges()