Page.MasterPageFile Vlastnost

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Získá nebo nastaví virtuální cestu stránky předlohy.

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

Hodnota vlastnosti

String

Virtuální cesta stránky předlohy.

Výjimky

InvalidOperationException

Vlastnost MasterPageFile se nastaví po PreInit dokončení události.

HttpException

Soubor zadaný ve MasterPageFile vlastnosti neexistuje.

-nebo-

Stránka nemá ovládací prvek Content jako ovládací prvek nejvyšší úrovně.

Poznámky

Vlastnost MasterPageFile je virtuální cesta (z kořenového adresáře aplikace) souboru stránky předlohy přidruženého k této stránce. Vlastnost MasterPageFile lze nastavit pouze v PreInit události; pokus o nastavení MasterPageFile vlastnosti po PreInit události vyvolá InvalidOperationException výjimku. MasterPageFile Pokud vlastnost není platná, vyvolá se výjimka typu HttpException později v životním cyklu stránky, ale při nastavení vlastnosti v PreInit události se nevyvolá žádná výjimka.

Stránky, které mají nastavenou MasterPageFile vlastnost, jsou stránky obsahu, a proto mohou obsahovat pouze ovládací prvky nejvyšší úrovně, které jsou Content ovládacími prvky.

Viz také

• Master
• Principy stránek předlohy