@ Master
定義 ASP.NET Web 網頁剖析器和編譯器使用的主版頁面 (Master Page) 專用 (.master 檔案) 屬性。
<%@ Master attribute="value" [attribute="value"...] %>
屬性
詞彙 |
定義 |
|---|---|
AutoEventWireup |
表示是否能使用語法 Page 在沒有明確連結或事件簽章的情況下定義特定檔案生命週期階段的簡單事件處理常式。 如果啟用事件自動寫入，則為 true，否則為 false。 預設值為 true。 如需詳細資訊，請參閱 ASP.NET Web Server Control Event Model。 |
ClassName |
指定為從標記自動產生並在處理主版頁面時編譯的類別指定類別名稱。 這個值可以是任何有效的類別名稱，且可包含命名空間。 |
CodeFile |
指定包含具有事件處理常式和其他主版頁面專用程式碼的部分類別之不同檔案的名稱。 如需詳細資訊，請參閱 ASP.NET Web Page Code Model。 |
CompilationMode |
指定是否在執行階段編譯 ASP.NET 主版頁面。 選項為 Always 表示始終編譯頁面；如果 ASP.NET 要避免編譯頁面，則為 Auto (如果可能)；Never 表示永不編譯頁面或控制項。 預設值為 Always。 |
CompilerOptions |
提供包含要用來編譯頁面之編譯器選項的字串。 在 C# 和 Microsoft Visual Basic 中，這是一連串的編譯器命令列參數。 |
Debug |
表示是否使用偵錯符號編譯主版頁面。 true 表示使用偵錯符號編譯，否則為 false。 |
Description |
提供主版頁面的文字描述。 ASP.NET 剖析器會忽略這個值。 |
EnableTheming |
表示在套用佈景主題時，主版頁面與主版頁面上控制項的外觀是否可以修改。 如果可以套用佈景主題，則為 true，否則為 false。 預設值為 true。 如果頁面主題依照預設在 Web.config 檔案中定義並套用至所有頁面，則設定 EnableTheming 屬性會非常有用。 如需詳細資訊，請參閱ASP.NET Themes Overview。 |
EnableViewState |
表示檢視狀態是否要在所有網頁要求之間都要維持。 true 表示保持檢視狀態，否則為 false。 預設值為 true。 |
Explicit |
決定網頁是否使用 Visual Basic Option Explicit 模式編譯。 true 表示啟用 Visual Basic 的明確編譯選項，而且所有的變數必須使用 Dim、Private、Public 或 ReDim 陳述式來宣告，否則為 false。 預設值為 false。 .gif "Note") Note
除了 Visual Basic 以外的語言都會忽略 Explicit 屬性。
Explicit 屬性在 Machine.config 檔案中設定為 true。 如需詳細資訊，請參閱 Machine Configuration Files。 |
Inherits |
指定頁面要繼承的程式碼後置 (Code-Behind) 類別。 這可以是從 MasterPage 類別衍生的任何類別。 如需程式碼後置類別的詳細資訊，請參閱 ASP.NET Page Class Overview。 |
Language |
指定編譯頁面內所有內嵌 (Inline) 轉譯 (<% %> 和 <%= %>) 和程式碼宣告區塊時使用的語言。 值可以代表 .NET Framework 所支援的任何語言，包括 VB (Visual Basic)、C# 和 JScript。 |
LinePragmas |
判斷執行階段是否應在產生的程式碼中產生 Pragma。 |
MasterPageFile |
為主版頁面指定充當主版頁面的 .master 檔案。 當在巢状主版頁面的案例中定義子主版頁面時，MasterPageFile 屬性會用於主版頁面。 如需詳細資訊，請參閱Nested ASP.NET Master Pages。 |
Src |
指定當要求網頁時，以動態方式編譯之程式碼後置類別的原始程式檔 (Source File) 名稱。 您可以選擇在 .aspx 檔案中的程式碼後置類別或 程式碼宣告區塊 中包含頁面的程式設計邏輯。 |
Strict |
指定是否使用 Visual Basic Option Strict 模式編譯網頁。 如果啟用 Option Strict，則為 true，否則為 false。 預設值為 false。 Note
除了 Visual Basic 以外的語言都會忽略 Strict 屬性。
|
WarningLevel |
指定您希望編譯器中止頁面編譯的編譯器警告層級。 可能的值為 0 到 4。 如需詳細資訊，請參閱 WarningLevel。 |
備註
您僅可以在主版頁面中使用 @ Master 指示詞。 主版頁面是定義在副檔名為 .master 的檔案中。 您只能在每個 .master 檔案中包含一個 @ Master 指示詞。
範例
下列程式碼範例示範如何指示 ASP.NET 網頁編譯器將 Visual Basic 用做內嵌程式碼語言。 事件處理程式碼在名為 MasterPageSample 的部分類別中定義。 您可以在 MasterPageSample.master.vb 檔案中找到 MasterPageSample 類別的程式碼。
<% @ Master Language="VB" CodeFile="MasterPageSample.master.vb" Inherits="MasterPageSample" %>
請參閱
概念
ASP.NET Web Page Syntax Overview