Page.MasterPageFile Page.MasterPageFile Page.MasterPageFile Page.MasterPageFile Property

定義

マスター ページの仮想パスを取得または設定します。Gets or sets the virtual path of the master page.

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

プロパティ値

マスター ページの仮想パス。The virtual path of the master page.

例外

MasterPageFile プロパティは PreInit イベントの完了後に設定されます。The MasterPageFile property is set after the PreInit event is complete.

MasterPageFile プロパティで指定されたファイルが存在しません。The file specified in the MasterPageFile property does not exist.

- または --or- ページに、最上位のコントロールである Content コントロールがありません。The page does not have a Content control as the top level control.

注釈

MasterPageFileプロパティは、このページに関連付けられているマスターページファイルの仮想パス (アプリケーションのルートから) です。The MasterPageFile property is a virtual path (from the root of the application) of the master page file associated with this page. プロパティMasterPageFileは、 PreInitイベントでのみ設定できMasterPageFileます。イベントのPreInit後にプロパティを設定しようとするInvalidOperationExceptionと、例外がスローされます。The MasterPageFile property can be set only in the PreInit event; attempting to set the MasterPageFile property after the PreInit event will throw an InvalidOperationException exception. プロパティが有効でない場合は、後で型HttpExceptionの例外がページライフサイクルでスローされますが、 PreInitイベントでプロパティが設定されている場合、例外はスローされません。 MasterPageFileIf the MasterPageFile property is not valid, an exception of type HttpException is thrown later in the page life cycle, but no exception is thrown when the property is set in the PreInit event.

プロパティが設定されているページはコンテンツページであるため、 Contentコントロールであるトップレベルコントロールのみを含めることができます。 MasterPageFilePages that have the MasterPageFile property set are content pages, and therefore can contain only top-level controls that are Content controls.

適用対象

こちらもご覧ください