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á Content ovládací prvek 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. MasterPageFile Vlastnost lze nastavit pouze v PreInit události; pokus o MasterPageFile nastavení vlastnosti po PreInit události vyvolá InvalidOperationException výjimku. MasterPageFile Pokud vlastnost není platná, je vyvolán 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í MasterPageFile sadu 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