@ Master
업데이트: 2007년 11월
ASP.NET 페이지 파서 및 컴파일러에 사용되는 마스터 페이지(.master 파일) 관련 특성을 정의합니다.
<%@ Master attribute="value" [attribute="value"...] %>
특성
용어 |
정의 |
|---|---|
AutoEventWireup |
명시적인 연결이나 이벤트 시그니처 없이 Page 구문을 사용하여 특정 주기 단계에 대해 간단한 이벤트 처리기를 정의할 수 있는지 여부를 나타냅니다. 이벤트 자동 연결을 사용하면 true이고, 그렇지 않으면 false입니다. 기본값은 true입니다. 자세한 내용은 ASP.NET 웹 서버 컨트롤 이벤트 모델을 참조하십시오. |
ClassName |
자동으로 태그에서 생성되고 마스터 페이지가 처리될 때 컴파일되는 클래스의 이름을 지정합니다. 이 값은 유효한 클래스 이름일 수 있으며 네임스페이스를 포함할 수 있습니다. |
CodeFile |
이벤트 처리기 및 기타 마스터 페이지 관련 코드가 들어 있는 partial 클래스가 포함된 개별 파일의 이름을 지정합니다. 자세한 내용은 ASP.NET 웹 페이지 코드 모델을 참조하십시오. |
CompilationMode |
ASP.NET 마스터 페이지를 런타임에 컴파일할지 여부를 지정합니다. 페이지를 항상 컴파일하는 Always 옵션, ASP.NET이 판단하여 가능하면 페이지를 컴파일하지 않는 Auto 옵션, 페이지나 컨트롤을 컴파일하지 않는 Never 옵션 중에서 선택할 수 있습니다. 기본값은 Always입니다. |
CompilerOptions |
페이지를 컴파일할 때 사용할 컴파일러 옵션이 포함된 문자열을 제공합니다. C#과 Microsoft Visual Basic에서 이 특성은 컴파일러 명령줄 스위치 시퀀스입니다. |
Debug |
디버그 기호를 사용하여 마스터 페이지를 컴파일할지 여부를 나타냅니다. 디버그 기호를 사용하여 컴파일하려면 true이고, 그렇지 않으면 false입니다. |
Description |
마스터 페이지에 대한 텍스트 설명을 제공합니다. 이 값은 ASP.NET 파서에서 무시됩니다. |
EnableTheming |
테마를 적용하여 마스터 페이지와 마스터 페이지에 있는 컨트롤의 모양을 수정할 수 있는지 여부를 나타냅니다. 테마를 적용할 수 있으면 true이고, 그렇지 않으면 false입니다. 기본값은 true입니다. EnableTheming 특성은 Web.config 파일에 정의되어 있는 페이지 테마가 모든 페이지에 기본적으로 적용되는 경우에 설정하면 유용합니다. 자세한 내용은 ASP.NET 테마 및 스킨 개요를 참조하십시오. |
EnableViewState |
뷰 상태가 페이지 요청 사이에 유지되는지 여부를 나타냅니다. 뷰 상태를 유지하려면 true이고, 그렇지 않으면 false입니다. 기본값은 true입니다. |
Explicit |
Visual Basic Option Explicit 모드를 사용하여 페이지를 컴파일할지 결정합니다. true로 설정하면 Visual Basic 명시적 컴파일 옵션을 사용함을 나타내며 이 경우 Dim, Private, Public 또는 ReDim 문을 사용하여 모든 변수를 선언해야 합니다. 그렇지 않으면 false로 설정합니다. 기본값은 false입니다. 참고 Explicit 특성은 Visual Basic 이외의 언어에서 무시됩니다. Explicit 특성은 Machine.config 파일에 true로 설정되어 있습니다. 자세한 내용은 컴퓨터 구성 파일을 참조하십시오. |
Inherits |
상속할 페이지에 대한 코드 숨김 클래스를 지정합니다. 이 클래스는 MasterPage 클래스에서 파생된 모든 클래스일 수 있습니다. 코드 숨김 클래스에 대한 자세한 내용은 ASP.NET 페이지 클래스 개요를 참조하십시오. |
Language |
페이지 내의 모든 인라인 렌더링(<% %> 및 <%= %>) 및 코드 선언 블록을 컴파일하는 데 사용되는 언어를 지정합니다. 값은 VB(Visual Basic), C#, JScript 등 .NET Framework에 지원되는 모든 언어를 나타낼 수 있습니다. |
LinePragmas |
런타임에서 생성되는 코드에 pragma를 생성할지 여부를 결정합니다. |
MasterPageFile |
마스터 페이지에 대한 마스터 페이지로 사용되는 .master 파일을 지정합니다. MasterPageFile 특성은 중첩된 마스터 페이지 시나리오에서 자식 마스터 페이지를 정의할 경우에 마스터 페이지에 사용됩니다. 자세한 내용은 중첩된 ASP.NET 마스터 페이지를 참조하십시오. |
Src |
페이지가 요청될 때 동적으로 컴파일될 코드 숨김 클래스의 소스 파일 이름을 지정합니다. 페이지에 대한 프로그래밍 논리를 코드 숨김 클래스 또는 .aspx 파일의 코드 선언 블록에 포함할 수 있습니다. |
Strict |
Visual Basic Option Strict 모드를 사용하여 페이지를 컴파일할지 지정합니다. Option Strict를 사용하면 true이고, 그렇지 않으면 false입니다. 기본값은 false입니다. 참고 Strict 특성은 Visual Basic 이외의 언어에서 무시됩니다. |
WarningLevel |
컴파일러에서 페이지에 대해 컴파일 작업을 중단하는 경고 수준을 지정합니다. 0-4 사이의 값 중에서 선택할 수 있습니다. 자세한 내용은 WarningLevel을 참조하십시오. |
설명
@ Master 지시문은 마스터 페이지에만 사용할 수 있습니다. 마스터 페이지는 확장명이 .master인 파일에 정의됩니다. 각 .master 파일에는 하나의 @ Master 지시문만 포함될 수 있습니다.
예제
다음 코드 예제에서는 Visual Basic을 인라인 코드 언어로 사용하도록 ASP.NET 페이지 컴파일러에 지시하는 방법을 보여 줍니다. 이벤트 처리 코드는 MasterPageSample이라는 partial 클래스에 정의됩니다. MasterPageSample 클래스의 코드는 MasterPageSample.master.vb 파일에 있습니다.
<% @ Master Language="VB" CodeFile="MasterPageSample.master.vb" Inherits="MasterPageSample" %>