Page.MasterPageFile Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Overridable Property MasterPageFile As StringValor da propriedade
O caminho virtual da página mestra.
Exceções
A propriedade MasterPageFile é definida após o evento PreInit ser concluído.
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 mestra 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.
