ASP <asp>

Статья
07/19/2023

Общие сведения

Элемент <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()