pages 요소(ASP.NET 설정 스키마)
업데이트: 2007년 11월
구성 파일 범위에 있는 컨트롤과 페이지에 대해 ASP.NET 지시문과 같은 페이지별 구성 설정을 전역으로 정의합니다.
configuration 요소(일반 설정 스키마)
system.web 요소(ASP.NET 설정 스키마)
pages 요소(ASP.NET 설정 스키마)
<pages
buffer="[True|False]"
enableEventValidation="[True|False]"
enableSessionState="[True|False|ReadOnly]"
enableViewState="[True|False]"
enableViewStateMac="[True|False]"
smartNavigation="[True|False]"
autoEventWireup="[True|False]"
pageBaseType="typename, assembly"
userControlBaseType="typename"
validateRequest="[True|False]"
masterPageFile="file path"
theme="string"
styleSheetTheme="string"
maxPageStateFieldLength="number"
compilationMode="[Always|Auto|Never]"
pageParserFilterType="string"
viewStateEncryptionMode="[Always|Auto|Never]"
maintainScrollPositionOnPostBack="[True|False]"
asyncTimeout="number"
>
<controls>...</controls>
<namespaces>...</namespaces>
<tagMapping>...</tagMapping>
</pages>
특성 및 요소
다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
특성
특성 |
설명 |
||||||||
|---|---|---|---|---|---|---|---|---|---|
asyncTimeout |
선택적 TimeSpan 특성입니다. 비동기 처리를 수행하는 동안 비동기 처리기가 완료될 때까지 대기할 시간(초)을 지정합니다. 이 특성은 .NET Framework 버전 2.0에서 새로 도입되었습니다. 기본값은 "0:00:45"(45초)입니다. |
||||||||
autoEventWireup |
선택적 Boolean 특성입니다. 페이지 이벤트를 자동으로 설정할지 여부를 지정합니다. 즉, 자동 이벤트 연결이 발생하여 시스템에서 특정 시그니처의 메서드(예: page_Load)를 자동으로 연결하는지 여부를 지정합니다. 자세한 내용은 ASP.NET 웹 서버 컨트롤 이벤트 모델을 참조하십시오. 기본값은 True입니다. |
||||||||
buffer |
선택적 Boolean 특성입니다. URL 리소스가 응답 버퍼링을 사용할지 여부를 지정합니다. 기본값은 True입니다. |
||||||||
compilationMode |
선택적 CompilationMode 특성입니다. ASP.NET 페이지나 컨트롤을 런타임 시 컴파일할 것인지 여부를 지정합니다. compilationMode 특성은 .NET Framework 2.0에서 새로 도입되었습니다. 이 특성은 다음 값 중 하나일 수 있습니다. 기본값은 Always입니다.
|
||||||||
enableEventValidation |
페이지 및 컨트롤에서 다시 게시 및 콜백 이벤트의 유효성을 검사하는지 여부를 지정합니다. 기본값은 True입니다. |
||||||||
enableSessionState |
선택적 String 특성입니다. 구성 파일의 범위에 있는 리소스의 세션 상태 요구 사항을 지정합니다. enableSessionState 특성은 다음 값 중 하나일 수 있습니다. 기본값은 True입니다.
|
||||||||
enableViewState |
선택적 Boolean 특성입니다. 뷰 상태가 설정되고 페이지 요청 간에 유지되는지 여부를 지정합니다. 기본값은 True입니다. |
||||||||
enableViewStateMac |
선택적 Boolean 특성입니다. 클라이언트에서 페이지가 다시 게시되는 경우 ASP.NET이 해당 페이지의 뷰 상태에 대해 MAC(메시지 인증 코드)를 실행할지 여부를 지정합니다. True로 설정하면 암호화된 뷰 상태를 확인하여 클라이언트에서 변경되었는지 여부가 확인됩니다. 기본값은 True입니다. |
||||||||
maintainScrollPositionOnPostBack |
선택적 Boolean 특성입니다. 페이지가 서버에 다시 게시될 때 사용자를 클라이언트 브라우저에서 같은 위치로 반환할 것인지 여부를 지정합니다. False이면 다시 게시할 때 사용자가 페이지의 맨 위로 반환됩니다. 이 특성은 .NET Framework 2.0에서 새로 도입되었습니다. 기본값은 False입니다. |
||||||||
masterPageFile |
선택적 String 특성입니다. 로컬 구성 파일에 상대적인 마스터 페이지 경로를 지정합니다. masterPageFile 특성이 True로 설정된 페이지에는 Content 컨트롤이 최상위 컨트롤로 포함되어 있어야 합니다. 이 특성은 .NET Framework 2.0에서 새로 도입되었습니다. 기본값은 빈 문자열("")입니다. |
||||||||
maxPageStateFieldLength |
선택적 Int32 특성입니다. 페이지의 상태 필드에 대한 최대 길이(문자 수)를 지정합니다. 값을 양수로 설정하면 클라이언트 브라우저에 전송된 뷰 상태 필드가 여러 개의 청크로 분할되고 각 청크는 maxPageStateFieldLength 특성에 지정된 크기보다 작습니다. 값을 음수로 설정하면 뷰 상태 필드가 청크로 분할되지 않습니다. 이 특성은 .NET Framework 2.0에서 새로 도입되었습니다. 기본값은 "-1"입니다. |
||||||||
pageBaseType |
선택적 String 특성입니다. 독립 실행형 전용 페이지에 사용할 기본 형식을 지정합니다. 이 값은 독립 실행형 파일의 inherits 특성에 의해 재정의됩니다. 기본값은 "System.Web.UI.Page"입니다. |
||||||||
pageParserFilterType |
선택적 String 특성입니다. 구문 분석할 때 특정 항목을 페이지에 사용할 수 있는지 여부를 결정하기 위해 ASP.NET 파서에서 사용하는 필터의 종류 이름을 지정합니다. 필터는 PageParserFilter 클래스에서 파생되어야 합니다. 이 특성은 .NET Framework 2.0에서 새로 도입되었습니다. 기본값은 빈 문자열("")입니다. |
||||||||
smartNavigation |
선택적 Boolean 특성입니다. 스마트 탐색의 설정 여부를 지정합니다. 스마트 탐색 기능을 사용하려면 Microsoft Internet Explorer 버전 5.5 이상이 필요합니다. 스마트 탐색 기능을 사용하면 다음과 같은 이점이 있습니다.
이 특성은 .NET Framework 2.0에서 새로 도입되었지만 maintainScrollPositionOnPostBack 특성이 대신 사용됩니다. 기본값은 False입니다. |
||||||||
styleSheetTheme |
선택적 String 특성입니다. 컨트롤을 선언한 후에 적용할 테마를 정의하는 theme 특성과 달리 컨트롤을 선언하기 전에 테마를 적용하는 데 사용할 "명명된 테마" 폴더의 이름을 지정합니다. 이 특성은 .NET Framework 2.0에서 새로 도입되었습니다. 기본값은 빈 문자열("")입니다. |
||||||||
theme |
선택적 String 특성입니다. 구성 파일 범위에 있는 페이지에 사용되는 테마의 이름을 지정합니다. 지정한 테마는 응용 프로그램이나 전역 테마로 있어야 합니다. 테마가 없으면 HttpException 예외가 throw됩니다. 이 특성은 .NET Framework 2.0에서 새로 도입되었습니다. 기본값은 빈 문자열("")입니다. |
||||||||
userControlBaseType |
선택적 String 특성입니다. 독립 실행형 전용 페이지에 사용할 기본 형식을 지정합니다. 기본값은 "System.Web.UI.UserControl"입니다. |
||||||||
validateRequest |
선택적 Boolean 특성입니다. ASP.NET이 잠재적으로 유해한 데이터를 찾기 위해 브라우저를 통한 모든 입력 내용을 검토함을 나타냅니다. True로 설정하면 잠재적으로 유해한 값 목록에 모든 입력 데이터를 비교하여 요청 유효성 검사가 수행됩니다. 일치하는 항목이 있으면 ASP.NET에서는 HttpRequestValidationException 예외를 발생시킵니다. 기본값은 True입니다. |
||||||||
viewStateEncryptionMode |
선택적 ViewStateEncryptionMode 특성입니다. 뷰 상태의 암호화 모드를 지정합니다. ViewStateEncryptionMode 속성은 구성 파일에 설정된 이 특성을 재정의합니다. 이 특성은 다음 값 중 하나일 수 있습니다.
이 특성은 .NET Framework 2.0에서 새로 도입되었습니다. 기본값은 Auto입니다. |
자식 요소
요소 |
설명 |
|---|---|
controls |
태그 접두사가 있는 네임스페이스와 register 지시문의 컬렉션을 정의합니다. |
namespaces |
어셈블리를 미리 컴파일하는 동안 사용할 import 지시문의 컬렉션을 정의합니다. |
tagMapping |
컴파일 타임에 다른 태그 형식으로 다시 매핑되는 태그 형식의 컬렉션을 정의합니다. |
부모 요소
요소 |
설명 |
|---|---|
configuration |
공용 언어 런타임 및 .NET Framework 기반 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소입니다. |
system.web |
구성 파일에서 ASP.NET 구성 설정에 대한 루트 요소를 지정하며, ASP.NET 웹 응용 프로그램을 구성하고 응용 프로그램의 동작 방식을 제어하는 구성 요소를 포함합니다. |
설명
pages 요소는 페이지별 구성 설정을 정의합니다. 이 구성 섹션은 구성 파일의 범위에 있는 모든 페이지와 컨트롤에 대한 특정 ASP.NET 페이지 및 컨트롤 지시문의 전역 설정을 지원합니다. 여기에는 ASP.NET Web Forms 페이지(.aspx)와 사용자 정의 컨트롤 파일(.ascx)을 처리할 때 해당 페이지와 사용자 정의 컨트롤 컴파일러에서 사용하는 설정을 지정하는 다음과 같은 페이지 수준의 지시문이 포함됩니다.
@ Page 지시문(@ Page)
namespaces 자식 요소를 통한 @ Import 지시문(@ Import)
controls 자식 요소를 통한 @ Register 지시문(@ Register)
pages 요소를 사용하면 tagMapping 요소를 통해 런타임에 태그 형식을 다른 태그 형식에 매핑할 수도 있습니다.
참고
@ Page 지시문을 마스터 페이지에 추가해도 마스터에 종속되는 페이지의 지시문 선언과 동일한 선언을 사용할 수 없습니다. 대신 pages 구성 요소를 사용하여 페이지 지시문을 전역으로 정의할 수 있습니다.
기본 구성
다음의 기본 pages 요소는 Machine.config 파일 또는 루트 Web.config 파일에 명시적으로 구성되어 있지 않습니다. 그러나 이 요소는 응용 프로그램에서 반환하는 기본 구성입니다. 네임스페이스 및 컨트롤은 루트 Web.config 파일에 추가되어 있습니다.
<pages
buffer="true"
enableSessionState="true"
enableViewState="true"
enableViewStateMac="true"
smartNavigation="false"
autoEventWireup="true"
pageBaseType="System.Web.UI.Page"
userControlBaseType="System.Web.UI.UserControl"
validateRequest="true"
masterPageFile=""
theme=""
styleSheetTheme=""
maxPageStateFieldLength="-1"
compilationMode="Always"
pageParserFilterType=""
viewStateEncryptionMode="Auto"
maintainScrollPositionOnPostBack="false"
asyncTimeout="45"
>
<namespaces>
<clear />
</namespaces>
<tagMapping>
<clear />
</tagMapping>
</pages>
예제
다음 코드 예제에서는 다양한 페이지 구성 설정을 지정하는 방법을 보여 줍니다.
<configuration>
<system.web>
<pages buffer="true"
enableSessionState="true"
autoEventWireup="true"
maintainScrollPositionOnPostBack="true"
masterPageFile = "~/Masters/Page1.master" />
</system.web>
</configuration>
요소 정보
구성 섹션 처리기 |
|
구성 멤버 |
|
구성 가능한 위치 |
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 |
참고 항목
작업
개념
참조
pages 요소에 대한 controls 요소(ASP.NET 설정 스키마)
pages 요소에 대한 namespaces 요소(ASP.NET 설정 스키마)
pages 요소에 대한 tagMapping 요소(ASP.NET 설정 스키마)