@ Page

  • 아티클

[이 설명서는 미리 보기 전용이며, 이후 릴리스에서 변경될 수 있습니다. 비어 있는 항목은 자리 표시자로 포함됩니다.]

ASP.NET 페이지 파서 및 컴파일러에 사용되는 페이지(.aspx 파일) 관련 특성을 정의합니다.

<%@ Page attribute="value" [attribute="value"...] %>

특성

  • Async
    페이지를 비동기 처리기로 지정합니다. 즉, 해당 페이지에서 IHttpAsyncHandler를 구현하여 요청을 처리할 수 있습니다.

    기본값은 false입니다.

  • AsyncTimeOut
    비동기 작업을 처리할 때 사용되는 시간 제한 간격(초)을 정의합니다. 기본값은 45초입니다.

    이 값은 정수여야 합니다.

    자세한 내용은 AsyncTimeout 속성을 참조하십시오.

  • AspCompat
    true로 설정하면 STA(단일 스레드 아파트) 스레드에서 페이지를 실행할 수 있습니다. 이렇게 하면 페이지에서 STA 구성 요소(예: Microsoft Visual Basic 6.0에서 개발된 구성 요소)를 호출할 수 있습니다. 이 특성을 true로 설정하면 관리되지 않는 ASP(Active Server Pages)의 기본 제공 개체에 액세스해야 하는 COM+ 버전 1.0 구성 요소도 페이지에서 호출할 수 있습니다. 이러한 구성 요소는 ObjectContext 개체 또는 OnStartPage 메서드를 통해 액세스할 수 있습니다. 기본값은 false입니다.

    참고

    이 특성을 true로 설정하면 페이지의 성능이 저하될 수 있습니다.자세한 내용은 설명 단원을 참조하십시오.

  • AutoEventWireup
    페이지의 이벤트가 자동으로 연결되는지 여부를 나타냅니다. 이벤트 자동 연결이 활성화되면 true이고, 그렇지 않으면 false입니다. 기본값은 true입니다. 자세한 내용은 ASP.NET Web Server Control Event Model를 참조하십시오.

  • Buffer
    HTTP 응답 버퍼링을 활성화할지 여부를 결정합니다. 페이지 버퍼링을 사용하면 true이고, 그렇지 않으면 false입니다.

    기본값은 true입니다.

  • ClassName
    페이지가 요청될 때 동적으로 컴파일되는 페이지 클래스의 이름을 지정하는 문자열입니다. 이 값은 모든 유효한 클래스 이름이 될 수 있으며 정규화된 클래스 이름을 포함할 수 있습니다. 이 특성에 값을 지정하지 않으면 컴파일된 페이지의 클래스 이름은 해당 페이지의 파일 이름을 기반으로 하고 기본 네임스페이스인 ASP가 사용됩니다. ClassName 특성 값을 전체 네임스페이스 없이 지정하면 네임스페이스 ASP가 사용되고, 이 네임스페이스가 지정한 클래스 이름과 결합되어 정규화된 클래스 이름을 만듭니다.

    다른 페이지는 @ Reference 지시문을 사용하여 첫 번째 페이지에 할당된 클래스 이름을 참조할 수 있습니다.

    참고

    코드 숨김 페이지 클래스에서 .aspx 페이지의 정규화된 클래스 이름을 사용하여 관련 .aspx 페이지의 멤버를 참조할 수도 있습니다.그러나 소스 보호를 사용하여 사이트를 미리 컴파일한 경우 코드 숨김 페이지 클래스가 .aspx 페이지 클래스와 다른 어셈블리에 있게 됩니다.따라서 코드 숨김 파일의 클래스 참조가 작동하지 않습니다.미리 컴파일에 대한 자세한 내용은 ASP.NET Web Site Precompilation Overview를 참조하십시오.

  • ClientIDMode
    컨트롤에 대해 ClientID 값을 사용할 알고리즘을 지정합니다. 기본값은 Predictable입니다. 컨트롤의 기본값은 Inherit입니다. 따라서, 페이지에서 컨트롤에 대한 기본 알고리즘은 페이지의 ClientID 설정에 의해 결정됩니다. 다른 기본값은 Web.config 파일의 Page 요소에서 설정할 수 있습니다. 알고리즘에 대한 자세한 내용은 ClientIDMode 클래스를 참조하십시오.

  • ClientTarget
    ASP.NET 서버 컨트롤에서 내용을 렌더링할 대상 사용자 에이전트를 나타냅니다. 일반적으로 Microsoft Internet Explorer와 같은 웹 브라우저가 여기에 해당됩니다. 이 값은 응용 프로그램 구성 파일의 <clientTarget> 섹션에 정의된 유효한 별칭일 수 있습니다. 자세한 내용은 ClientTarget 속성을 참조하십시오.

  • CodeBehind
    페이지와 연결된 클래스를 포함하는 컴파일된 파일의 이름을 지정합니다. 이 특성은 런타임에는 사용되지 않습니다.

    이 특성은 웹 응용 프로그램 프로젝트에 사용됩니다. CodeFile 특성은 웹 사이트 프로젝트에 사용됩니다. Visual Studio의 웹 프로젝트 형식에 대한 자세한 내용은 Visual Studio 웹 사이트 프로젝트 및 웹 응용 프로그램 프로젝트를 참조하십시오.

  • CodeFile
    페이지에 대해 참조된 코드 숨김 파일의 경로를 지정합니다. 이 특성은 Inherits 특성과 함께 사용되어 코드 숨김 소스 파일을 웹 페이지와 연결합니다. 이 특성은 컴파일된 페이지에만 유효합니다.

    이 특성은 웹 사이트 프로젝트에 사용됩니다. CodeBehind 특성은 웹 응용 프로그램 프로젝트에 사용됩니다. Visual Studio의 웹 프로젝트 형식에 대한 자세한 내용은 Visual Studio 웹 사이트 프로젝트 및 웹 응용 프로그램 프로젝트를 참조하십시오.

  • CodeFileBaseClass
    페이지의 기본 클래스 및 연결된 코드 숨김 클래스의 형식 이름을 지정합니다. 이 특성은 선택적 요소이지만 사용될 경우에는 CodeFile 특성도 있어야 합니다. 웹 페이지에 선언된 컨트롤을 참조하기 위해 기본 클래스에서 공용 필드 및 연결된 이벤트(옵션)를 정의하는 공유 시나리오를 구현하려는 경우에 이 특성을 사용합니다. 이 특성을 사용하지 않고 기본 클래스에서 필드를 정의한 경우에는 ASP.NET 코드 생성 모델 때문에 컴파일할 때 웹 페이지에 선언된 컨트롤에 대해 새 멤버 정의가 별도의 partial 클래스 스텁에 생성되고 원하는 시나리오가 제대로 실행되지 않습니다. 그러나 CodeFileBaseClass 특성을 사용하여 기본 클래스를 페이지와 연결하고 partial 클래스(클래스 이름은 Inherits 특성에 할당되고 소스 파일은 CodeFile 특성에 의해 참조됨)가 기본 클래스에서 상속되게 하면 코드 생성 후에 기본 클래스의 필드에서 페이지의 컨트롤을 참조할 수 있습니다.

  • CodePage
    응답에 사용되는 인코딩 체계의 값을 나타냅니다. 이 값은 인코딩 체계의 ID로 사용되는 정수입니다. 가능한 CodePage ID 목록을 보려면 Encoding 클래스를 참조하십시오.

  • CompilationMode
    몇 가지 열거 옵션 중 하나를 지정하는 문자열을 사용하여 페이지를 컴파일할지 여부를 설정합니다. 기본값은 Always이므로 .aspx 페이지는 기본적으로 컴파일됩니다. 자세한 내용은 CompilationMode 열거형을 참조하십시오.

  • CompilerOptions
    페이지를 컴파일할 때 사용하는 컴파일러 옵션이 포함된 문자열입니다. C#과 Visual Basic에서 이 특성은 컴파일러 명령줄 스위치 시퀀스입니다. 컴파일러 옵션에 대한 자세한 내용은 C# 컴파일러 옵션 또는 Visual Basic 명령줄 컴파일러를 참조하십시오.

  • ContentType
    응답의 HTTP 콘텐츠 형식을 표준 MIME 형식으로 정의하며 유효한 모든 HTTP 콘텐츠 형식 문자열을 지원합니다. 사용 가능한 값 목록을 보려면 MSDN Library에서 MIME을 검색하십시오.

  • Culture
    페이지에 대한 문화권 설정을 나타냅니다. 이 특성 값은 유효한 문화권을 ID가 있어야 합니다. LCID 특성과 Culture 특성은 함께 사용할 수 없습니다. 이러한 특성 중 하나를 사용하는 경우에는 같은 페이지에서 다른 특성을 사용할 수 없습니다. 자세한 내용은 Culture 속성 및 CultureInfo 클래스를 참조하십시오.

  • Debug
    디버그 기호를 사용하여 페이지를 컴파일해야 할지 여부를 나타냅니다. 디버그 기호를 사용하여 페이지를 컴파일해야 하는 경우 true이고, 그렇지 않은 경우 false입니다. 이 설정은 성능에 영향을 주므로 개발하는 동안에만 이 특성을 true로 설정해야 합니다.

  • Description
    페이지에 대한 텍스트 설명을 제공하며 이 값은 ASP.NET 파서에서 무시됩니다.

  • EnableEventValidation
    포스트백 및 콜백 시나리오에서 이벤트 유효성 검사를 사용하도록 합니다. 이벤트가 유효성 검사되고 있으면 true이고, 그렇지 않으면 false입니다. 기본값은 true입니다.

    페이지 이벤트 유효성 검사를 통해 다시 게시 요청 및 콜백이 무단으로 수행될 위험을 줄일 수 있습니다. enableEventValidation 속성이 true로 설정된 경우 ASP.NET에서 다시 게시 요청 또는 콜백 도중 컨트롤에서 발생할 수 있는 이벤트만 허용됩니다. 이 모델을 사용하면 컨트롤에서 렌더링 도중 해당 이벤트를 등록한 다음 다시 게시 또는 콜백 처리 도중 이벤트의 유효성을 검사합니다. ASP.NET의 모든 이벤트 구동 컨트롤에서는 기본적으로 이 기능을 사용합니다.

    이벤트 유효성 검사는 해제하지 않는 것이 좋습니다. 이벤트 유효성 검사를 해제하기 전에, 응용 프로그램에 의도하지 않은 영향을 주는 방식으로 다시 게시를 구성할 수 없도록 해야 합니다.

  • EnableSessionState
    페이지에 대한 세션 상태 요구 사항을 정의합니다. 세션 상태가 설정되어 있으면 true, 세션 상태를 읽을 수는 있지만 변경할 수 없으면 ReadOnly, 그렇지 않으면 false입니다. 기본값은 true입니다. 이들 값은 대/소문자를 구분하지 않습니다. 자세한 내용은 ASP.NET Session State Overview를 참조하십시오.

  • EnableTheming
    페이지에 테마가 사용되는지 여부를 나타냅니다. 테마가 사용되면 true이고, 그렇지 않으면 false입니다. 기본값은 true입니다.

  • EnableViewState
    뷰 상태가 페이지 요청 간에 유지되는지 여부를 지정합니다. 이 값은 뷰 상태가 유지되는 경우 true 또는 뷰 상태가 유지되지 않는 경우 false입니다. 기본값은 true입니다.

    이 속성을 true로 설정하더라도 다음 조건 중 하나라도 적용할 경우 뷰 상태는 컨트롤에 대해 유지되지 않습니다.

    뷰 상태와 컨트롤 상태에 대한 자세한 내용은 Control.EnableViewState 속성을 참조하십시오.

  • EnableViewStateMac
    클라이언트에서 페이지를 다시 게시할 때 ASP.NET에서 페이지의 뷰 상태에 대해 MAC(메시지 인증 코드)를 확인해야 한다는 것을 나타냅니다. 뷰 상태를 MAC로 검사해야 하면 true이고, 그렇지 않으면 false입니다. 기본값은 true입니다.

    뷰 상태 MAC는 브라우저에 전송할 때 페이지의 뷰 상태가 유지되는 숨겨진 변수의 암호화된 버전입니다. 뷰 상태가 클라이언트에서 변경되었는지 여부를 검사하기 위해 MAC를 사용합니다.

    보안 정보보안 정보

    이 특성은 프로덕션 웹 사이트에서 절대 false로 설정하면 안됩니다.

  • ErrorPage
    처리되지 않은 예외가 발생하는 경우에 리디렉션할 대상 URL을 정의합니다. 자세한 내용은 ErrorPage 속성을 참조하십시오.

  • Explicit
    Visual Basic Option Explicit 모드를 사용하여 페이지를 컴파일할지 여부를 결정합니다. true로 설정하면 Visual Basic의 명시적 컴파일 옵션이 사용되며 이 경우 Dim, Private, Public 또는 ReDim 문을 사용하여 모든 변수를 선언해야 합니다. 그렇지 않으면 false로 설정합니다. 기본값은 false입니다.

    참고

    이 특성은 Visual Basic 이외의 언어에서 무시됩니다.또한 이 옵션은 Machine.config 구성 파일에서 true로 설정됩니다.자세한 내용은 ASP.NET Configuration Files을 참조하십시오.

  • Inherits
    상속할 페이지에 대한 코드 숨김 클래스를 정의하며 이 클래스는 Page 클래스에서 파생된 모든 클래스일 수 있습니다. 이 특성은 코드 숨김 클래스의 소스 파일 경로가 들어 있는 CodeFile 특성과 함께 사용됩니다. 페이지 언어로 C#을 사용하는 경우에는 Inherits 특성에 대/소문자가 구분되고, 페이지 언어로 Visual Basic을 사용하는 경우에는 대/소문자가 구분되지 않습니다.

    Inherits 특성에 네임스페이스가 들어 있지 않은 경우 ASP.NET에서는 ClassName 특성에 네임스페이스가 들어 있는지 여부를 확인합니다. 네임스페이스가 들어 있으면 ASP.NET에서는 ClassName 특성의 네임스페이스를 사용하여 Inherits 특성에 참조된 클래스를 로드하려고 합니다. 이때 Inherits 특성과 ClassName 특성에 같은 네임스페이스가 사용되었다고 가정됩니다.

    코드 숨김 클래스에 대한 자세한 내용은 ASP.NET Web Page Code Model을 참조하십시오.

  • Language
    페이지 내의 모든 인라인 렌더링(<% %> 및 <%= %>) 및 코드 선언 블록을 컴파일하는 데 사용되는 언어를 지정합니다. 값은 Visual Basic, C# 또는 JScript를 포함하여 .NET Framework에서 지원되는 모든 언어를 나타낼 수 있지만, 각 페이지에 대해 언어를 하나만 사용하고 지정할 수 있습니다.

  • LCID
    Web Forms 페이지에 대한 로캘 식별자를 정의합니다.

    참고

    로캘 식별자는 로캘을 고유하게 정의하는 32비트 값입니다.사용자가 이 특성을 사용하여 Web Forms 페이지에 사용할 다른 로캘을 지정하지 않으면 ASP.NET에서는 웹 서버의 기본 로캘을 사용합니다.LCID 특성과 Culture 특성은 함께 사용할 수 없습니다. 이러한 특성 중 하나를 사용하는 경우에는 같은 페이지에서 다른 특성을 사용할 수 없습니다.로캘에 대한 자세한 내용을 보려면 MSDN Library를 검색하십시오.

  • LinePragmas
    런타임에 소스 코드에서 줄 pragma를 생성할지 여부를 결정합니다. 이 옵션은 소스 파일에서 특정 위치를 표시하기 위해 디버깅 도구에 주로 사용되는 컴파일러 옵션입니다. 줄 pragmas를 생성해야 한다면 true이고, 그렇지 않으면 false입니다.

  • MaintainScrollPositionOnPostback
    포스트백 후 클라이언트 브라우저의 동일한 위치에 사용자를 반환할지 여부를 나타냅니다. 사용자가 같은 위치로 돌아가야 한다면 true이고, 그렇지 않으면 false입니다. 기본값은 false입니다.

    참고

    개발자는 Web.config 파일의 <pages> 요소에서 maintainScrollPostitionOnPostback 특성(구성 파일에서 대/소문자 구분)을 설정하여 모든 페이지에 대해 이 특성을 정의할 수 있습니다.

  • MasterPageFile
    중첩된 마스터 페이지 또는 콘텐츠 페이지에 대한 마스터 페이지의 경로를 설정합니다. 이 특성은 상대 경로와 절대 경로를 지원합니다. 자세한 내용은 MasterPageFile 속성을 참조하십시오.

  • MetaDescription
    MetaDescription 속성을 설정합니다. 페이지 태그에 "description" meta 요소도 포함된 경우 @ Page 지시물의 값은 태그의 값을 무시합니다.

  • MetaKeywords
    MetaKeywords 속성을 설정합니다. 페이지 태그에 "keywords" meta 요소도 포함된 경우 @ Page 지시물의 값은 태그의 값을 무시합니다.

  • ResponseEncoding
    페이지 내용이 포함된 HTTP 응답에 사용되는 인코딩 체계의 이름을 나타냅니다. 이 특성에 할당된 값은 유효한 인코딩 이름입니다. 가능한 인코딩 목록을 보려면 Encoding 클래스를 참조하십시오. GetEncodings 메서드를 호출해도 사용 가능한 인코딩 이름 및 ID 목록을 확인할 수 있습니다.

  • SmartNavigation
    페이지에서 Internet Explorer 5.5 이상의 스마트 탐색 기능을 지원하는지 여부를 나타냅니다. 스마트 탐색이 사용되는 경우에는 true이고, 그렇지 않으면 false입니다. 기본값은 false입니다.

    ASP.NET 버전 2.0 이상에서는 SmartNavigation 속성이 사용되지 않습니다. 대신 SetFocus 메서드 및 MaintainScrollPositionOnPostback() 속성을 사용합니다.

  • Src
    페이지에 링크된 코드를 포함하는 소스 파일의 경로를 지정합니다. 링크된 소스 파일에서 페이지에 대한 프로그래밍 논리를 클래스 또는 코드 선언 블록에 포함하도록 선택할 수 있습니다.

    Src 특성을 사용하여 빌드 공급자를 페이지에 링크할 수 있습니다. 자세한 내용은 BuildProvider 클래스를 참조하십시오. 또한 ASP.NET 2.0 이전 버전에서는 코드 숨김 파일을 페이지에 링크하는 대안으로 Src 특성을 사용했습니다. ASP.NET 2.0에서는 코드 숨김 소스 파일을 페이지에 링크할 때 Inherits 특성을 사용하여 클래스를 지정하고 CodeFile 특성을 사용하여 클래스의 소스 파일 경로를 지정하는 것이 좋습니다.

  • Strict
    Visual Basic Option Strict 모드를 사용하여 페이지를 컴파일할지 나타냅니다. Option Strict가 사용되면 true이고, 그렇지 않으면 false입니다. 기본값은 false입니다.

    참고

    이 특성은 Visual Basic 이외의 언어에서 무시됩니다.

  • StyleSheetTheme
    페이지에 사용할 올바른 테마 식별자를 지정합니다. StyleSheetTheme 특성이 설정되면 개별 컨트롤은 테마에 포함된 스타일 설정을 재정의할 수 있습니다. 따라서 테마에는 사이트의 전반적인 모양을 지정하고, StyleSheetTheme 특성에 포함된 설정을 사용하여 페이지와 개별 컨트롤의 특정 설정을 사용자 지정할 수 있습니다.

  • TargetSchema
    페이지의 내용이 유효한지 검사하는 데 사용되는 스키마의 이름을 지정합니다. 이 특성은 설명적 용도로만 사용되고 실제 유효성 검사가 수행되지 않으므로 파서에서 무시됩니다.

  • Theme
    페이지에 사용할 올바른 테마 식별자를 지정합니다. StyleSheetTheme 특성을 사용하지 않고 Theme 특성을 설정하면 컨트롤의 개별 스타일 설정이 재정의되어 페이지에서 일관성 있는 모양을 만들 수 있습니다. 자세한 내용은 Theme 속성을 참조하십시오.

  • Title
    응답에서 HTML <title> 태그 내에 렌더링되는 페이지 제목을 지정합니다. 이 제목은 프로그래밍 방식을 통해 페이지의 속성으로 액세스할 수도 있습니다. 자세한 내용은 Title 속성을 참조하십시오.

  • Trace
    추적의 활성화 여부를 나타냅니다. 추적을 사용할 수 있으면 true이고, 그렇지 않으면 false입니다. 기본값은 false입니다. 자세한 내용은 ASP.NET Tracing Overview 및 Trace 속성을 참조하십시오.

  • TraceMode
    추적이 설정되어 있는 경우 페이지에 대해 추적 메시지를 표시하는 방법을 나타냅니다. 가능한 값은 SortByTime과 SortByCategory입니다. 추적이 설정되어 있는 경우 기본값은 SortByTime입니다. 추적에 대한 자세한 내용은 ASP.NET Tracing Overview를 참조하십시오.

  • Transaction
    페이지에서 COM+ 트랜잭션이 지원되는지 여부를 나타냅니다. 가능한 값은 Disabled, NotSupported, Supported, Required 및 RequiresNew입니다. 기본값은 Disabled입니다.

  • UICulture
    페이지에 사용할 UI(사용자 인터페이스) 문화권 설정을 지정합니다. 유효한 UI 문화권 값은 모두 지원합니다. 자세한 내용은 UICulture 속성을 참조하십시오.

  • ValidateRequest
    요청 유효성 검사를 수행할지 여부를 나타냅니다. true인 경우에는 잠재적으로 위험한 값의 하드 코드된 목록을 기준으로 모든 입력 데이터에 대해 요청 유효성 검사가 수행됩니다. 일치하는 항목이 있으면 HttpRequestValidationException 예외가 throw됩니다. 기본값은 true입니다.

    이 기능은 컴퓨터 구성 파일(Machine.config)에서 활성화됩니다. 응용 프로그램 구성 파일(Web.config) 또는 페이지에서 이 특성을 false로 설정하여 요청 유효성 검사 기능을 비활성화할 수 있습니다.

    참고

    이 기능은 간단한 페이지 및 ASP.NET 응용 프로그램에 대해 수행되는 사이트 간 스크립팅 공격의 위험을 줄이는 데 도움이 됩니다.사용자 입력이 유효한지 제대로 검사하지 않는 응용 프로그램은 사이트 간 스크립팅, Microsoft SQL Server 삽입 공격 등을 포함하여 다양한 유형의 잘못된 입력 공격을 받을 수 있습니다.응용 프로그램에 수행되는 모든 형식의 입력을 주의해서 평가하고, 입력 데이터를 적절히 검사 또는 인코딩하며, 데이터를 조작하거나 정보를 클라이언트로 다시 보내기 전에 응용 프로그램이 공격을 받지 않도록 하는 것이 가장 좋은 방법입니다.

  • ViewStateEncryptionMode
    뷰 상태를 암호화하는 방법을 지정합니다. 이때 Auto, Always 또는 Never라는 세 개의 열거형 값을 사용할 수 있습니다. 기본값은 Auto입니다. 즉, 개별 컨트롤에서 요청하는 경우 뷰 상태가 암호화됩니다. 자세한 내용은 ViewStateEncryptionMode 열거형을 참조하십시오.

  • ViewStateMode
    컨트롤의 ViewStateMode 속성이 Inherit일 때 컨트롤에 영향을 미치는 ViewStateMode 속성 값을 지정합니다. 페이지의 기본 ViewStateMode 값은 Enabled입니다.

    ViewStateMode 및 EnableViewState 속성은 페이지의 컨트롤에 대한 뷰 상태가 유지되는지 여부를 결정합니다. 자세한 내용은 EnableViewState 속성 및 ViewStateMode 속성을 참조하십시오.

  • WarningLevel
    컴파일러에서 경고를 오류로 처리하여 페이지의 컴파일 작업을 중단하는 컴파일러 경고 수준을 나타냅니다. 가능한 경고 수준은 0에서 4 사이입니다. 자세한 내용은 WarningLevel 속성을 참조하십시오.

설명

이 지시문은 Web Forms 페이지에서만 사용할 수 있으며 각 .aspx 파일에는 @ Page 지시문이 하나만 포함될 수 있습니다. 또한 각 페이지에 대해 하나의 언어만 사용할 수 있으므로 @ Page 지시문마다 Language 특성을 하나만 정의할 수 있습니다. 대부분의 특성에는 가장 일반적으로 사용되는 기본값이 지정되므로 소스 코드 또는 구성 파일에서 다양한 특성 집합을 지시문에 추가할 필요가 없습니다. 일반적으로 페이지에 특정 기능을 지정하는 데 필요한 최소 특성 집합만 추가해야 합니다. 모든 페이지에 적용할 공통 특성이 있는 경우, 예를 들어 모든 페이지에 추적 기능을 설정하려는 경우에는 각 페이지에 Trace 특성을 개별적으로 추가하지 않고 Web.config 파일에서 추적 기능을 설정할 수 있습니다.

참고

@ Page 지시문에는 웹 사용자 정의 컨트롤의 .ascx 파일에 사용되는 @ Control 지시문과 마스터 페이지의 .master 파일에 사용되는 @ Master 지시문 등의 다른 지시문과 마찬가지로 전체 소스 파일에 적용되는 다양한 특성이 있습니다.

@ Page 지시문에 여러 특성을 정의하려면 각 특성/값 쌍을 단일 공백으로 구분합니다. 특정 특성의 경우에는 특성과 값을 연결하는 등호(=)의 앞/뒤에 공백을 포함하면 안 됩니다. 예제를 보려면 이 항목의 예제 단원을 참조하십시오.

스마트 탐색은 Internet Explorer 5.5 이상 브라우저에서 지원되는 ASP.NET 기능입니다. 이 기능을 사용하면 탐색하는 동안 스크롤 위치와 요소 포커스를 유지한 채로 페이지를 새로 고칠 수 있으므로, 브라우저의 기록에는 단 하나의 페이지만 저장되며 웹 페이지를 새로 고칠 때 일반적으로 발생하는 깜박임이 없습니다. 스마트 탐색은 빈번하게 다시 게시해야 하지만 반환 시에 가시적 내용이 크게 변하지 않는 ASP.NET 페이지에서 사용하기에 가장 적합합니다. 이 특성을 true로 설정할지 여부를 결정할 때 이 점을 고려해야 합니다.

페이지의 AspCompat 특성이 true로 설정된 경우 요청이 예약되기 전에 생성자를 사용하여 COM 구성 요소를 만들면 해당 구성 요소는 MTA(다중 스레드 아파트) 스레드에서 실행됩니다. 이렇게 하면 웹 서버 성능이 크게 저하됩니다. 이 문제를 방지하려면 Page 이벤트(예: Page_Load, Page_Init 등) 또는 Page 메서드 내에서만 COM 구성 요소를 만들어야 합니다. 또한 페이지를 생성할 때 개체를 만들면 안됩니다.

다음 코드 예제에서는 AspCompat 특성이 설정된 페이지에서 COM 개체의 인스턴스를 만들기 위해 권장되는 방법을 보여 줍니다.

<%@ Page AspCompat="true" language="C#" %>
<script runat="server" >

MyComObject comObj;

public void Page_Load(){
   // Use comObj here when the code is running on the STA thread pool.
   comObj = New MyComObject();
   // Do something with the combObj object.
}

<%@ Page AspCompat="true" language="VB" %>
<script runat="server" >

    Dim comObj As MyComObject 

    Public Sub Page_Load()
     'Use comObj here when the code is running on the STA thread pool.
     comObj = New MyComObject()
     ' Do something with the combObj object.
    End Sub
</script>

참고

@ Master 지시문을 마스터 페이지에 추가해도 마스터에 종속되는 페이지의 지시문 선언과 동일한 선언을 사용할 수 없습니다.대신 pages 요소를 사용하여 페이지 지시문을 전역으로 정의할 수 있습니다.

예제

다음 코드 예제에서는 ASP.NET 페이지 컴파일러에서 Visual Basic을 페이지의 서버 쪽 코드 언어로 사용하도록 지정하고, 클라이언트에 전송되는 기본 HTTP MIME ContentType 특성을 "text/xml"로 설정합니다.

<%@ Page Language="VB" ContentType="text/xml" %>

참고 항목

참조

텍스트 템플릿 지시문 구

@ Control

@ Master

기타 리소스

ASP.NET 페이지 구문