Page.MasterPageFile Właściwość
Definicja
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
Ścieżka wirtualna strony wzorcowej.
Wyjątki
Właściwość MasterPageFile jest ustawiana po zakończeniu PreInit zdarzenia.
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.