Page.MasterPageFile プロパティ

.NET Framework クラス ライブラリ リファレンス

Page.MasterPageFile プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

マスタ ページのファイル名を取得または設定します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 MasterPageFile As String

Visual Basic (使用法)

Dim instance As Page
Dim value As String

value = instance.MasterPageFile

instance.MasterPageFile = value

C#

public virtual string MasterPageFile { get;
 set; }

C++

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

J#

/** @property */
public String get_MasterPageFile ()

/** @property */
public void set_MasterPageFile (String value)

JScript

public function get MasterPageFile
 () : String

public function set MasterPageFile
 (value : String)

プロパティ値
マスタ ページのファイル名。

例外

例外の種類	条件
InvalidOperationException	MasterPageFile プロパティは PreInit イベントの完了後に設定されます。
HttpException	MasterPageFile プロパティで指定されたファイルが存在しません。 または ページに、最上位のコントロールである Content コントロールがありません。

解説

MasterPageFile プロパティは、対象のページに関連付けられたマスタ ページのファイル名です。MasterPageFile プロパティは、PreInit イベントのみに設定できます。PreInit イベントの後で MasterPageFile プロパティを設定しようとすると InvalidOperationException 例外がスローされます。

MasterPageFile プロパティが設定されたページはコンテンツ ページです。そのため、このようなページは Content コントロールという最上位のコントロールだけを保持できます。

Topic	Location
方法 : ASP.NET マスタ ページ用のコンテンツ ページを作成する (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : ASP.NET マスター ページのコンテンツを参照する	ASP .NET Web アプリケーションの作成

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Page クラス
Page メンバ
System.Web.UI 名前空間
Page.Master プロパティ
その他の技術情報
ASP.NET マスター ページの概要