Page.MasterPageFile Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

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

Zobacz też