Page.MasterPageFile Property

Definition

Ottiene o imposta il percorso virtuale della pagina master.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

Property Value

String

Percorso virtuale della pagina master.The virtual path of the master page.

Exceptions

La proprietà MasterPageFile viene impostata al termine dell'evento PreInit.The MasterPageFile property is set after the PreInit event is complete.

Il file specificato nella proprietà MasterPageFile non esiste.The file specified in the MasterPageFile property does not exist.

-oppure--or-

La pagina non include un controllo Content come controllo di primo livello.The page does not have a Content control as the top level control.

Remarks

La proprietà MasterPageFile è un percorso virtuale (dalla radice dell'applicazione) del file della pagina master associato a questa pagina.The MasterPageFile property is a virtual path (from the root of the application) of the master page file associated with this page. È possibile impostare la proprietà MasterPageFile solo nell'evento PreInit; il tentativo di impostare la proprietà MasterPageFile dopo che l'evento PreInit genererà un'eccezione InvalidOperationException.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. Se la proprietà MasterPageFile non è valida, viene generata un'eccezione di tipo HttpException in un secondo momento nel ciclo di vita della pagina, ma non viene generata alcuna eccezione quando la proprietà viene impostata nell'evento PreInit.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.

Le pagine che hanno il set di proprietà MasterPageFile sono pagine di contenuto e pertanto possono contenere solo controlli di primo livello Content controlli.Pages that have the MasterPageFile property set are content pages, and therefore can contain only top-level controls that are Content controls.

Applies to

See also