Page.MasterPageFile Page.MasterPageFile Page.MasterPageFile Page.MasterPageFile Property

Definition

Ruft den virtuellen Pfad der Masterseite ab oder legt diesen fest.Gets or sets the virtual path of the master page.

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.The virtual path of the master page.

Ausnahmen

Die MasterPageFile-Eigenschaft wird nach Abschluss des PreInit-Ereignisses festgelegt.The MasterPageFile property is set after the PreInit event is complete.

Die in der MasterPageFile-Eigenschaft angegebene Datei ist nicht vorhanden.The file specified in the MasterPageFile property does not exist.

- oder --or- Die Seite verfügt über kein Content-Steuerelement als Steuerelement der obersten Ebene.The page does not have a Content control as the top level control.

Hinweise

Die MasterPageFile -Eigenschaft ist ein virtueller Pfad (aus dem Stamm der Anwendung) der der Seite zugeordneten Masterseiten Datei.The MasterPageFile property is a virtual path (from the root of the application) of the master page file associated with this page. Die MasterPageFile -Eigenschaft kann nur PreInit im-Ereignis festgelegt werden. Wenn PreInit Sie MasterPageFile versuchen, die-Eigenschaft festzulegen InvalidOperationException , wird eine Ausnahme ausgelöst.The MasterPageFile property can be set only in the PreInit event; attempting to set the MasterPageFile property after the PreInit event will throw an InvalidOperationException exception. Wenn die MasterPageFile Eigenschaft nicht gültig ist, wird eine Ausnahme vom HttpException Typ später im Lebenszyklus der Seite ausgelöst, aber es wird keine Ausnahme ausgelöst, wenn die- PreInit Eigenschaft im-Ereignis festgelegt wird.If the MasterPageFile property is not valid, an exception of type HttpException is thrown later in the page life cycle, but no exception is thrown when the property is set in the PreInit event.

Seiten, bei denen MasterPageFile die-Eigenschaft festgelegt ist, sind Inhaltsseiten und können daher nur Steuerelemente der Content obersten Ebene enthalten, die Steuerelemente sind.Pages that have the MasterPageFile property set are content pages, and therefore can contain only top-level controls that are Content controls.

Gilt für:

Siehe auch