Page.MasterPageFile Propriedade

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Obtém ou define o caminho virtual da página mestra.

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

Valor da propriedade

String

O caminho virtual da página mestra.

Exceções

InvalidOperationException

A MasterPageFile propriedade é definida após a conclusão do PreInit evento.

HttpException

O arquivo especificado na MasterPageFile propriedade não existe.

- ou -

A página não tem um Content controle como o controle de nível superior.

Comentários

A MasterPageFile propriedade é um caminho virtual (da raiz do aplicativo) do arquivo de página mestra associado a esta página. A MasterPageFile propriedade só pode ser definida no PreInit evento; tentar definir a MasterPageFile propriedade após o PreInit evento gerará uma exceção InvalidOperationException . Se a MasterPageFile propriedade não for válida, uma exceção de tipo HttpException será lançada posteriormente no ciclo de vida da página, mas nenhuma exceção será gerada quando a propriedade for definida no PreInit evento.

As páginas que têm o MasterPageFile conjunto de propriedades são páginas de conteúdo e, portanto, podem conter apenas controles de nível superior que são Content controles.

Confira também

• Master
• Noções básicas sobre páginas mestras