Page.MasterPageFile 屬性

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

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

主版頁面的虛擬路徑。

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

HttpException

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

-或-

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

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

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