Page.MasterPageFile Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den virtuellen Pfad der Masterseite ab oder legt diesen fest.
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
Eigenschaftswert
Der virtuelle Pfad der Gestaltungsvorlage.
Ausnahmen
Die MasterPageFile-Eigenschaft wird nach Abschluss des PreInit-Ereignisses festgelegt.
Die in der MasterPageFile-Eigenschaft angegebene Datei ist nicht vorhanden.
- oder -
Die Seite verfügt über kein Content-Steuerelement als Steuerelement der obersten Ebene.
Hinweise
Die MasterPageFile Eigenschaft ist ein virtueller Pfad (aus dem Stamm der Anwendung) der Gestaltungsvorlagendatei, die dieser Seite zugeordnet ist. Die MasterPageFile -Eigenschaft kann nur im PreInit Ereignis festgelegt werden. Wenn Sie versuchen, die MasterPageFile Eigenschaft festzulegen, nachdem das PreInit Ereignis eine InvalidOperationException Ausnahme auslöst. Wenn die MasterPageFile Eigenschaft ungültig ist, wird später im Seitenlebenszyklus eine Ausnahme vom Typ HttpException ausgelöst, aber keine Ausnahme wird ausgelöst, wenn die Eigenschaft im PreInit Ereignis festgelegt wird.
Seiten, für die die MasterPageFile Eigenschaft festgelegt ist, sind Inhaltsseiten und dürfen daher nur Steuerelemente der obersten Ebene enthalten, die Steuerelemente sind Content .