@ Master

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

Define atributos mestre page–specific (arquivo. master) que são usados pelo processo do ASP.O analisador de página NET e do compilador.

<%@ Master attribute="value" [attribute="value"...] %>

Atributos

Termo

Definição

AutoEventWireup

Indica se os manipuladores de eventos simples podem ser definidas para os estágios do ciclo de vida específico usando a sintaxe Page sem qualquer assinatura explícita de evento ou a conexão. trueSe a ligação automática do evento estiver habilitada; Caso contrário, false. O padrão é true. Para obter mais informações, consulte ASP.NET Web Server Control Event Model.

ClassName

Especifica o nome da classe para a classe que é gerado a partir da marcação e compilado quando a página mestra é processada automaticamente. Esse valor pode ser qualquer nome de classe válido e pode incluir um espaço para nome.

CodeFile

Especifica o nome de um arquivo separado que contém uma classe parcial com os manipuladores de eventos e outros códigos de page–specific mestre. Para obter mais informações, consulte ASP.NET Web Page Code Model.

CompilationMode

Especifica se a compilar um aplicativo ASP.NET página mestra em tempo de execução. As opções são Always sempre compilar a página. Auto, se ASP.NET é evitar a compilação da página, se possível; e Never, nunca compilar a página ou controle. O padrão é Always.

CompilerOptions

Fornece uma seqüência de caracteres contendo opções do compilador para usar para compilar a página. No C# e de Visual Basic da Microsoft, isso é uma seqüência de opções de linha de comando do compilador.

Debug

Indica se é necessário compilar a página mestra com símbolos de depuração. true, para compilar com símbolos de depuração; Caso contrário, false.

Description

Fornece uma descrição de texto da página mestra. Este valor é ignorado pelo compilador do ASP.Analisador de rede.

EnableTheming

Indica se a aparência da página mestra e dos controles na página mestra pode ser modificada, se um tema é aplicado. trueSe um tema pode ser aplicado; Caso contrário, false. O padrão é true. Definindo a EnableTheming atributo é útil principalmente quando um tema de página é definido no arquivo Web. config e se aplica a todas as páginas, por padrão. Para obter mais informações, consulte ASP.NET Themes Overview.

EnableViewState

Indica se o estado de exibição é mantido em solicitações de página. truepara manter o estado de exibição; Caso contrário, false. O padrão é true.

Explicit

Determina se a página é compilada usando o Visual Basic Option Explicit modo. trueindica que a opção de compilação explícita de Visual Basic é ativada e que todas as variáveis devem ser declaradas em um Dim, Private, Public, ou ReDim instrução; Caso contrário, false. O padrão é false.

NoteNote
O Explicit atributo é ignorado por linguagens diferentes, por exemplo, Visual Basic.

O Explicit atributo está definido como true no arquivo Machine. config. Para obter mais informações, consulte Machine Configuration Files.

Inherits

Especifica uma classe code-behind para a página herdar. Isso pode ser qualquer classe que deriva de MasterPage classe. Para obter informações sobre classes code-behind, consulte ASP.NET Page Class Overview.

Language

Especifica o idioma usado ao compilar todos os embutidos de renderização (<% %> e <%= %>) e a declaração blocos dentro da página de código. Valores podem representar qualquer linguagem compatível com o.NET Framework, incluindo VB (Visual Basic), C# e JScript.

LinePragmas

Determina se o tempo de execução deve gerar pragmas no código gerado.

MasterPageFile

Especifica o arquivo. Master que atua como uma página mestra para uma página mestra. O MasterPageFile atributo é usado em uma página mestra ao definir uma página-mestre filho em um cenário de página mestra aninhado. Para obter detalhes, consulte:Nested ASP.NET Master Pages.

Src

Especifica o nome do arquivo de origem da classe code-behind para compilar dinamicamente quando a página é solicitada. Você pode escolher incluir lógica de programação para a página em uma classe code-behind ou em um Blocos de declaração de código no arquivo. aspx.

Strict

Especifica se deve ser compilar a página usando o Visual Basic Option Strict modo. trueSe Option Strict está ativado. Caso contrário, false. O padrão é false.

NoteNote
O Strict atributo é ignorado por linguagens diferentes, por exemplo, Visual Basic.

WarningLevel

Especifica o nível de aviso do compilador no qual você deseja que o compilador para interromper a compilação da página. Valores possíveis são de 0 a 4. Para obter mais informações, consulte WarningLevel.

Remarks

Você pode usar o @ Master diretiva somente em páginas mestras. Páginas mestras são definidas em arquivos com a extensão. master. Você pode incluir apenas uma @ Master diretiva por arquivo. master.

Exemplo

O exemplo de código a seguir demonstra como instruir o ASP.Compilador de página NET para usar Visual Basic como o idioma de código embutido. O código de manipulação de eventos é definido em uma classe parcial chamada MasterPageSample. O código para o MasterPageSample classe pode ser encontrada na MasterPageSample.master.vb arquivo.

<% @ Master Language="VB" CodeFile="MasterPageSample.master.vb" Inherits="MasterPageSample" %>

Consulte também

Concepts

ASP.NET Web Page Syntax Overview

Other Resources

ASP.NET Master Pages Overview