Page.MasterPageFile Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia wirtualną ścieżkę strony wzorcowej.

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

Wartość właściwości

String

Ścieżka wirtualna strony wzorcowej.

Wyjątki

InvalidOperationException

Właściwość MasterPageFile jest ustawiana po zakończeniu PreInit zdarzenia.

HttpException

Plik określony we MasterPageFile właściwości nie istnieje.

-lub-

Strona nie ma Content kontrolki jako kontrolki najwyższego poziomu.

Uwagi

Właściwość MasterPageFile jest ścieżką wirtualną (z katalogu głównego aplikacji) pliku strony wzorcowej skojarzonej z tą stroną. Właściwość MasterPageFile można ustawić tylko w PreInit przypadku; próba ustawienia MasterPageFile właściwości po wystąpieniu PreInit zdarzenia spowoduje zgłoszenie InvalidOperationException wyjątku. MasterPageFile Jeśli właściwość jest nieprawidłowa, zgłaszany jest wyjątek typu HttpException w dalszej części cyklu życia strony, ale nie jest zgłaszany wyjątek, gdy właściwość jest ustawiona PreInit w zdarzeniu.

Strony, które mają MasterPageFile zestaw właściwości, to strony zawartości i dlatego mogą zawierać tylko kontrolki najwyższego poziomu, które są Content kontrolkami.

Dotyczy

Produkt	Wersje
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Udostępnij za pośrednictwem