pages 요소(ASP.NET 설정 스키마)

아티클
08/09/2011

구성 파일 범위에 있는 컨트롤과 페이지에 대해 ASP.NET 지시문과 같은 페이지별 구성 설정을 전역으로 정의합니다.

<pages     
   asyncTimeout="number"
   autoEventWireup="[True|False]"
   buffer="[True|False]"
   clientIDMode="[AutoID|Predictable|Static]"
   compilationMode="[Always|Auto|Never]" 
   controlRenderingCompatibilityVersion="[3.5|4.0]"
   enableEventValidation="[True|False]"
   enableSessionState="[True|False|ReadOnly]"
   enableViewState="[True|False]"
   enableViewStateMac="[True|False]"
   maintainScrollPositionOnPostBack="[True|False]" 
   masterPageFile="file path" 
   maxPageStateFieldLength="number" 
   pageBaseType="typename, assembly"
   pageParserFilterType="string" 
   smartNavigation="[True|False]"
   styleSheetTheme="string"
   theme="string"
   userControlBaseType="typename"
   validateRequest="[True|False]"
   viewStateEncryptionMode="[Always|Auto|Never]" 
>
   <controls>...</controls>
   <namespaces>...</namespaces>
   <tagMapping>...</tagMapping>
   <ignoreDeviceFilters>...</ignoreDeviceFilters>
</pages>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성	설명
asyncTimeout	선택적 TimeSpan 특성입니다. 비동기 처리를 수행하는 동안 비동기 처리기가 완료될 때까지 대기할 시간(초)을 지정합니다. 이 특성은 .NET Framework 버전 2.0에서 새로 도입되었습니다. 기본값은 "0:00:45"(45초)입니다.
autoEventWireup	선택적 Boolean 특성입니다. 페이지 이벤트를 자동으로 설정할지 여부를 지정합니다. 즉, 자동 이벤트 연결이 발생하여 시스템에서 특정 시그니처의 메서드(예: Page_Load)를 자동으로 연결하는지 여부를 지정합니다. 자세한 내용은 ASP.NET 웹 서버 컨트롤 이벤트 모델을 참조하십시오. 기본값은 True입니다.
buffer	선택적 Boolean 특성입니다. URL 리소스가 응답 버퍼링을 사용할지 여부를 지정합니다. 기본값은 True입니다.
clientIDMode	컨트롤에 대해 ClientID 값을 사용할 알고리즘을 지정합니다. 기본값은 Predictable입니다. 컨트롤의 기본값은 Inherit입니다. 따라서 페이지의 컨트롤에 대한 기본 알고리즘은 페이지의 ClientIDMode 설정에 의해 결정됩니다. 다른 기본값은 페이지의 @ Page 지시문 또는 사용자 컨트롤의 @ Control 지시문에서 설정할 수 있습니다. 알고리즘에 대한 자세한 내용은 ClientIDMode 및 ASP.NET 웹 서버 컨트롤 식별을 참조하십시오.
compilationMode	선택적 CompilationMode 특성입니다. ASP.NET 페이지나 컨트롤을 런타임 시 컴파일할 것인지 여부를 지정합니다. compilationMode 특성은 .NET Framework 2.0에서 새로 도입되었습니다. 이 특성은 다음 값 중 하나일 수 있습니다. 기본값은 Always입니다. 값설명 Always 페이지가 항상 컴파일됩니다. Auto 가능한 경우 ASP.NET에서 페이지를 컴파일하지 않습니다. Never 페이지나 컨트롤이 동적으로 컴파일되지 않습니다. 페이지에 컴파일해야 하는 스크립트 블록이나 코드 구문이 포함되어 있는 경우에는 ASP.NET에서 오류를 반환하며 페이지가 실행되지 않습니다.
controlRenderingCompatibilityVersion	컨트롤이 이전 버전의 ASP.NET에서 수행하는 방식이나 현재 버전에서 수행하도록 설계된 방식으로 HTML을 렌더링할지 여부를 지정합니다. 참고 controlRenderingCompatibilityVersion 은 ASP.NET 4에 새로 추가된 기능입니다.현재 버전 번호로 설정하는 것은 설정하지 않는 것과 같습니다.어느 경우나 현재 버전에 대해 설계된 대로 HTML을 컨트롤 렌더링합니다.이 특성이 설정할 수 있는 가장 오래된 버전은 3.5입니다. 자세한 내용은 PagesSection.ControlRenderingCompatibilityVersion 및 Control.RenderingCompatibility 속성을 참조하십시오.
enableEventValidation	페이지 및 컨트롤에서 다시 게시 및 콜백 이벤트의 유효성을 검사하는지 여부를 지정합니다. 기본값은 True입니다.
enableSessionState	선택적 String 특성입니다. 구성 파일의 범위에 있는 리소스의 세션 상태 요구 사항을 지정합니다. enableSessionState 특성은 다음 값 중 하나일 수 있습니다. 기본값은 True입니다. 값설명 False 세션 상태가 설정되지 않았음을 나타냅니다. ReadOnly 세션 상태를 쓸 수 없음을 나타냅니다. 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 속성은 구성 파일에 설정된 이 특성을 재정의합니다. 이 특성은 다음 값 중 하나일 수 있습니다. 값설명 Always 뷰 상태가 항상 암호화됩니다. Auto 컨트롤에서 요청하는 경우 뷰 상태가 암호화됩니다. Never 컨트롤에서 요청해도 뷰 상태가 암호화되지 않습니다. 이 특성은 .NET Framework 2.0에서 새로 도입되었습니다. 기본값은 Auto입니다.

자식 요소

요소	설명
controls	태그 접두사가 있는 네임스페이스와 register 지시문의 컬렉션을 정의합니다.
namespaces	어셈블리를 미리 컴파일하는 동안 사용할 import 지시문의 컬렉션을 정의합니다.
tagMapping	컴파일 타임에 다른 태그 형식으로 다시 매핑되는 태그 형식의 컬렉션을 정의합니다.
ignoreDeviceFilters	브라우저가 페이지 렌더링을 무시하는 장치 요소의 컬렉션을 정의합니다. 자세한 내용은 IgnoreDeviceFilters을 참조하십시오.

부모 요소

요소	설명
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" 
   clientIDMode="AutoID" 
   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>

요소 정보

구성 섹션 처리기	PagesSection
구성 멤버	Pages Page
구성 가능한 위치	Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config 가상 또는 실제 디렉터리 수준의 Web.config
요구 사항	Microsoft IIS(인터넷 정보 서비스) 버전 5.0 이상 .NET Framework 버전 1.0 이상 Microsoft Visual Studio 2003 이상

참고 항목

다음을 통해 공유