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> IIS 6.0 IIsWebService 개체의 ASP 관련 속성을 대체합니다. |
설치 프로그램
웹 서버에서 ASP 애플리케이션을 지원하고 구성하려면 ASP 모듈을 설치해야 합니다. ASP 모듈을 설치하려면 다음 단계를 사용합니다.
Windows Server 2012 또는 Windows Server 2012 R2
- 작업 표시줄에서 서버 관리자를 클릭합니다.
- 서버 관리자관리 메뉴를 클릭한 다음 역할 및 기능 추가를 클릭합니다.
- 역할 및 기능 추가 마법사에서 다음을 클릭합니다. 설치 유형을 선택하고 다음을 클릭합니다. 대상 서버를 선택하고 다음을 클릭합니다.
- 서버 역할 페이지에서 웹 서버(IIS)를 확장하고, 웹 서버를 확장하고, 애플리케이션 개발을 확장한 다음, ASP를 선택합니다.
- ASP에 필요한 기능 추가 대화 상자가 나타나면 기능 추가를 클릭합니다. (이 페이지는 서버에 ISAPI 확장 역할 서비스를 아직 설치하지 않은 경우에만 표시됩니다.)
- 서버 역할 페이지에서 다음을 클릭합니다.
- 기능 선택 페이지에서 다음을 클릭합니다.
- 설치 선택 확인 페이지에서 설치를 클릭합니다.
- Results(결과) 페이지에서 Close(닫기)를 클릭합니다.
Windows 8 또는 Windows 8.1
시작 화면에서 포인터를 왼쪽 아래 모서리로 이동하고 시작 단추를 마우스 오른쪽 단추로 클릭한 다음 제어판 클릭합니다.
제어판프로그램 및 기능을 클릭한 다음 Windows 기능 켜기 또는 끄기를 클릭합니다.
인터넷 정보 서비스를 확장하고 World Wide Web Services를 확장한 다음, 애플리케이션 개발 기능을 확장한 다음, ASP를 선택합니다.
참고
ISAPI 확장 역할이 아직 설치되지 않은 경우 선택됩니다.
확인을 클릭합니다.
닫기를 클릭합니다.
Windows Server 2008 또는 Windows Server 2008 R2
- 작업 표시줄에서 시작을 클릭하고 관리 도구를 가리킨 다음 서버 관리자 클릭합니다.
- 서버 관리자 계층 창에서 역할을 확장한 다음 웹 서버(IIS)를 클릭합니다.
- 웹 서버(IIS) 창에서 역할 서비스 섹션으로 스크롤한 다음 역할 서비스 추가를 클릭합니다.
- 역할 서비스 추가 마법사의 역할 서비스 선택 페이지에서 ASP를 선택합니다.
- ASP에 필요한 역할 서비스 추가 대화 상자가 나타나면 필요한 역할 서비스 추가를 클릭합니다. (이 페이지는 서버에 ISAPI 확장 역할 서비스를 아직 설치하지 않은 경우에만 표시됩니다.)
- 역할 서비스 선택 페이지에서 다음을 클릭합니다.
- 설치 선택 확인 페이지에서 설치를 클릭합니다.
- Results(결과) 페이지에서 Close(닫기)를 클릭합니다.
Windows Vista 또는 Windows 7
- 작업 표시줄에서 시작을 클릭한 다음 제어판 클릭합니다.
- 제어판프로그램 및 기능을 클릭한 다음 Windows 기능 켜기 또는 끄기를 클릭합니다.
- 인터넷 정보 서비스, World Wide Web Services, 애플리케이션 개발 기능을 차례로 확장합니다.
- 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 창에서 필요한 설정을 구성한 다음 작업 창에서 적용을 클릭합니다.
구성
ApplicationHost.config 파일의 서버 수준에서 요소를 구성할 <asp> 수 있습니다. 그러나 기본적으로 사이트 수준 또는 애플리케이션 수준에서 요소를 구성할 <asp> 수 없습니다.
특성
| attribute | Description |
|---|---|
appAllowClientDebug |
선택적 부울 특성입니다. 클라이언트 쪽 디버깅을 사용할지 여부를 지정합니다. 기본값은 false입니다. |
appAllowDebugging |
선택적 부울 특성입니다. 서버 쪽 디버깅을 사용할지 여부를 지정합니다. 기본값은 false입니다. |
bufferingOn |
선택적 부울 특성입니다. ASP 애플리케이션 출력의 버퍼링을 사용할 수 있는지 여부를 지정합니다. 기본값은 true입니다. |
calcLineNumber |
선택적 부울 특성입니다. ASP가 오류 보고서에 숫자를 제공하기 위해 실행된 각 코드 줄의 줄 번호를 계산하고 저장하는지 여부를 지정합니다. 기본값은 true입니다. |
codePage |
선택적 uint 특성입니다. ASP 애플리케이션의 기본 문자 집합을 지정합니다. 이 값은 0에서 2147483647 범위의 정수입니다. 예를 들어 값 1252는 기본 문자 집합을 미국 영어 및 많은 유럽 알파벳에서 사용되는 라틴 문자 집합으로 설정합니다. 기본값은 0입니다. |
enableApplicationRestart |
선택적 부울 특성입니다. 구성 설정이 변경될 때마다 ASP 애플리케이션을 자동으로 다시 시작할지 여부를 지정합니다. 기본값은 true입니다. |
enableAspHtmlFallback |
선택적 부울 특성입니다. 요청된 .asp 파일과 이름이 같은 .htm 파일이 있는 경우 .asp 파일 대신 클라이언트로 보낼지 여부를 지정합니다. 전체 요청 큐로 인해 요청이 거부되는 경우에 발생합니다. 기본값은 true입니다. |
enableChunkedEncoding |
선택적 부울 특성입니다. HTTP 1.1 청크 전송 인코딩을 사용할지 여부를 지정합니다. 기본값은 true입니다. |
enableParentPaths |
선택적 부울 특성입니다. ASP 페이지에서 현재 디렉터리를 기준으로 하는 경로 또는 현재 디렉터리 위에 대한 경로를 허용할지 여부를 지정합니다. 기본값은 false입니다. |
errorsToNTLog |
선택적 부울 특성입니다. Windows 이벤트 로그에 대한 ASP 오류 로깅을 사용할 수 있는지 여부를 지정합니다. 기본값은 false입니다. |
exceptionCatchEnable |
선택적 부울 특성입니다. COM 구성 요소 예외 트래핑을 사용할지 여부를 지정합니다. false로 설정하면 Microsoft 스크립트 디버거 도구는 디버깅 중인 구성 요소에서 보낸 예외를 catch하지 않습니다. 기본값은 true입니다. |
lcid |
선택적 uint 특성입니다. ASP 애플리케이션의 기본 로캘 식별자를 지정합니다. 이 값은 0에서 2147483647 범위의 정수입니다. 기본값은 0입니다. |
logErrorRequests |
선택적 부울 특성입니다. 기본적으로 ASP 오류가 클라이언트 브라우저 및 IIS 로그에 기록되는지 여부를 지정합니다. 기본값은 true입니다. |
runOnEndAnonymously |
선택적 부울 특성입니다. SessionOnEnd 및 ApplicationOnEnd 전역 ASP 함수를 익명 사용자로 실행할지 여부를 지정합니다. 기본값은 true입니다. |
scriptErrorMessage |
선택적 문자열 특성입니다. 특정 디버깅 오류가 클라이언트로 전송되지 않을 때 브라우저로 전송될 오류 메시지를 지정합니다. 기본값은 An error occurred on the server when processing the URL. Please contact the system administrator입니다. |
scriptErrorSentToBrowser |
선택적 부울 특성입니다. 클라이언트 브라우저에 대한 디버깅 세부 정보를 쓸 수 있는지 여부를 지정합니다. 기본값은 false입니다. |
scriptLanguage |
선택적 문자열 특성입니다. 웹 서버에서 실행되는 모든 ASP 애플리케이션에 대한 기본 스크립트 언어를 지정합니다. 기본값은 VBScript입니다. |
자식 요소
| 요소 | Description |
|---|---|
cache |
선택적 요소입니다. ASP 캐시 설정을 지정합니다. |
comPlus |
선택적 요소입니다. COM+ 설정을 지정합니다. |
limits |
선택적 요소입니다. 다양한 ASP 속성에 대한 제한을 지정합니다. |
session |
선택적 요소입니다. ASP 세션 상태 설정을 지정합니다. |
구성 샘플
다음 구성 예제에서는 Contoso라는 사이트에서 ASP 애플리케이션에 대한 버퍼링 및 세션 상태를 사용하도록 설정하고 동일한 사이트에 대한 부모 경로를 사용하지 않도록 설정합니다.
<location path="Contoso">
<system.webServer>
<asp enableParentPaths="false" bufferingOn="true">
<session allowSessionState="true" />
</asp>
</system.webServer>
</location>
샘플 코드
다음 코드 예제에서는 Contoso라는 사이트에서 ASP 애플리케이션에 대해 버퍼링 및 세션 상태를 사용하도록 설정하고 동일한 사이트에 대해 부모 경로를 사용하지 않도록 설정합니다.
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 사용하여 이러한 설정을 구성할 때 commit 매개 변수 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()