Page.MasterPageFile Propriedade

  • Referência

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 propriedade MasterPageFile é definida após o evento PreInit ser concluído.

HttpException

O arquivo especificado na propriedade MasterPageFile não existe.

- ou -

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

Comentários

A MasterPageFile propriedade é um caminho virtual (da raiz do aplicativo) do arquivo de página master associado a esta página. A MasterPageFile propriedade só pode ser definida no PreInit evento; tentar definir a MasterPageFile propriedade depois que o PreInit evento gerará uma exceção InvalidOperationException . Se a MasterPageFile propriedade não for válida, uma exceção do tipo HttpException será gerada 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 a MasterPageFile propriedade definida são páginas de conteúdo e, portanto, podem conter apenas controles de nível superior que são Content controles.

Aplica-se a

Confira também