@ Master
更新：2007 年 11 月
定義 ASP.NET Web 網頁剖析器和編譯器使用的主版頁面 (Master Page) 專用 (.master 檔案) 屬性。
<%@ Master attribute="value" [attribute="value"...] %>
屬性
詞彙 |
定義 |
||
|---|---|---|---|
AutoEventWireup |
表示是否能使用語法 Page 在沒有明確連結或事件簽章的情況下定義特定檔案生命週期階段的簡單事件處理常式。如果啟用事件自動連線，則為 true，否則為 false。預設值為 true。如需詳細資訊，請參閱 ASP.NET Web 伺服器控制項事件模型。 |
||
ClassName |
指定為從標記自動產生並在處理主版頁面時編譯的類別指定類別名稱。這個值可以是任何有效的類別名稱，且可包含命名空間。 |
||
CodeFile |
指定包含具有事件處理常式和其他主版頁面專用程式碼的部分類別之不同檔案的名稱。如需詳細資訊，請參閱 ASP.NET Web 網頁程式碼模型。 |
||
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 佈景主題和面板概觀。 |
||
EnableViewState |
表示是否透過頁面要求維護檢視狀態。true 表示維護檢視狀態，否則為 false。預設值為 true。 |
||
Explicit |
判斷網頁是否使用 Visual Basic Option Explicit 模式進行編譯。true 表示 Visual Basic 的明確編譯選項已啟用，且必須使用 Dim、Private、Public 或 ReDim 陳述式宣告所有變數，否則為 false。預設值為 false。
Explicit 屬性在 Machine.config 檔案中設定為 true。如需詳細資訊，請參閱 電腦組態檔。 |
||
Inherits |
指定頁面要繼承的程式碼後置 (Code-Behind) 類別。這可以是從 MasterPage 類別衍生的任何類別。如需程式碼後置類別的詳細資訊，請參閱 ASP.NET 網頁類別概觀。 |
||
Language |
指定編譯頁面內所有內嵌 (Inline) 轉譯 (<% %> 和 <%= %>) 和程式碼宣告區塊時使用的語言。值可以代表 .NET Framework 所支援的任何語言，包括 VB (Visual Basic)、C# 和 JScript。 |
||
LinePragmas |
判斷執行階段是否應在產生的程式碼中產生 Pragma。 |
||
MasterPageFile |
為主版頁面指定充當主版頁面的 .master 檔案。當在巢状主版頁面的案例中定義子主版頁面時，MasterPageFile 屬性會用於主版頁面。如需詳細資訊，請參閱巢狀 ASP.NET 主版頁面。 |
||
Src |
指定當要求網頁時，以動態方式編譯之程式碼後置類別的原始程式檔 (Source File) 名稱。您可以選擇在 .aspx 檔案中的程式碼後置類別或 程式碼宣告區塊 中包含頁面的程式設計邏輯。 |
||
Strict |
指定是否使用 Visual Basic Option Strict 模式編譯頁面。如果啟用 Option Strict 則為 true，否則為 false。預設值為 false。
|
||
WarningLevel |
指定您希望編譯器中止頁面編譯的編譯器警告層級。值的範圍為 0 到 4。如需詳細資訊，請參閱 WarningLevel。 |
.gif "注意事項")
注意事項：備註
您僅可以在主版頁面中使用 @ Master 指示詞。主版頁面是定義在副檔名為 .master 的檔案中。您只能在每個 .master 檔案中包含一個 @ Master 指示詞。
範例
下列程式碼範例示範如何指示 ASP.NET 網頁編譯器將 Visual Basic 用做內嵌程式碼語言。事件處理程式碼在名為 MasterPageSample 的部分類別中定義。您可以在 MasterPageSample.master.vb 檔案中找到 MasterPageSample 類別的程式碼。
<% @ Master Language="VB" CodeFile="MasterPageSample.master.vb" Inherits="MasterPageSample" %>