Page.MasterPageFile 屬性

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

取得或設定主版頁面的虛擬路徑。

public:
 virtual property System::String ^ MasterPageFile { System::String ^ get(); void set(System::String ^ value); };

public virtual string MasterPageFile { get; set; }

member this.MasterPageFile : string with get, set

Public Overridable Property MasterPageFile As String

屬性值

String

主版頁面的虛擬路徑。

例外狀況

InvalidOperationException

在 MasterPageFile 事件完成之後，會設定 PreInit 屬性。

HttpException

MasterPageFile 屬性中指定的檔案不存在。

-或-

頁面沒有 Content 控制項當做最上層控制項。

備註

屬性 MasterPageFile 是從與此頁面相關聯主版頁面檔案之應用程式根目錄) 的虛擬路徑 (。 屬性MasterPageFile只能在 事件中PreInit設定;嘗試在事件之後PreInit設定 MasterPageFile 屬性將會擲InvalidOperationException回例外狀況。 MasterPageFile如果屬性無效，則會在頁面生命週期稍後擲回類型的HttpException例外狀況，但在事件中PreInit設定屬性時不會擲回例外狀況。

具有 MasterPageFile 屬性集的頁面是內容頁面，因此只能包含控件的最上層控件 Content 。

另請參閱

• Master
• 瞭解主版頁面