Partilhar via


@ Page

Define atributos específicos de página (arquivo .aspx) usados pelo analisador de páginas ASP.NET e do compilador.

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

Atributos

  • Async
    Torna a página de um manipulador assíncrono (ou seja, ele faz a página usar uma implementação de IHttpAsyncHandler para processar solicitações).

    O padrão é false.

  • AsyncTimeOut
    Define o intervalo de time limite (em segundos) usado no processamento de tarefas assíncrono. O padrão é 45 segundos.

    O valor deve ser um inteiro.

  • AspCompat
    Quando definido como true, permite que a página a ser executado em um segmento de apartment single-threaded (STA). Isso permite que a página componentes de telefonar STA, sistema autônomo um componente desenvolvido com o Microsoft Visual Basic 6.0. A configuração desse atributo como true também permite que a página chamar componentes COM + versão 1.0 que exigem acesso a objetos internos do ativo servidor Pages (ASP) não gerenciado. Esses podem ser acessados por meio do ObjectContext objeto ou a OnStartPage método. O padrão é false.

    ObservaçãoObservação:

    A configuração desse atributo como true podem causar desempenho da sua página a ser prejudicado. Para obter mais informações, consulte a seção comentários.

  • AutoEventWireup
    Indica se os eventos da página estão vinculada automaticamente. true Se a vinculação automática de eventos é habilitado; caso contrário, false. O padrão é true. Para obter mais informações, consulte Modelo de Eventos de Controle do Servidor Web ASP.NET.

  • Buffer
    Determina se o buffer de resposta HTTP está ativado. true Se o buffer de página é habilitado; caso contrário, false.

    O padrão é true.

  • ClassName
    Uma seqüência de caracteres que especifica o nome da classe de página que será compilado dinamicamente quando a página é solicitada. Esse valor pode ser qualquer nome de classe válido e pode incluir um nome de classe totalmente qualificado. Se um valor para este atributo não for especificado, o nome de classe para a página compilada se baseia no nome de arquivo da página e usa o padrão namespace ASP. Se um valor para o ClassName atributo for especificado sem um espaço para nome completo, em seguida, o espaço para nome ASP é usado, combinado com o nome da classe especificada para criar um nome de classe totalmente qualificado.

    Outra página pode referenciar o nome de classe atribuído à primeira página usando o @ Referência diretiva.

    ObservaçãoObservação:

    É possível na classe de página code-behind para membros de referência da classe de página .aspx associado, usando o nome de classe totalmente qualificado para a página .aspx. No entanto, se você pré-compile seu site com proteção de fonte ativada, a classe code-behind da página não está no mesmo assembly sistema autônomo a classe de página .aspx. Portanto, a referência de classe no arquivo code-behind não funcionará. Para obter mais informações sobre como pré-compilação, consulte ASP.NET Precompilation Overview.

  • ClientTarget
    Indica agente do usuário de destino (normalmente, um navegador da Web, sistema autônomo o Microsoft Internet Explorer) para o qual ASP.NET controles de servidor devem processar o conteúdo. Esse valor pode ser qualquer válido alias conforme definido dentro de <clientTarget> seção do arquivo de configuração do aplicativo.

  • CodeBehind
    Especifica o nome do arquivo compilado que contém a classe associada à página. Esse atributo não é usado em time de execução.

    ObservaçãoObservação:

    Esse atributo é incluído para compatibilidade com versões anteriores do ASP.NET para implementar o recurso de code-behind. No ASP.NET 2.0, em vez disso, você deve usar o CodeFile atributo para especificar o nome do arquivo de fonte, juntamente com o Inherits atributo para especificar o nome totalmente qualificado da classe.

  • CodeFile
    Especifica um caminho para o arquivo referenciado code-behind da página. Este atributo é usado em conjunto com o Inherits atributo para associar um code-behind arquivo de fonte com uma página da Web. O atributo é válido somente para páginas compiladas.

  • CodeFileBaseClass
    Especifica o nome de tipo de uma classe base para uma página e sua classe code-behind associado. Esse atributo é opcional, mas quando é usada a CodeFile atributo também deve estar presente. Use este atributo quando desejar implementar um cenário compartilhado, onde você define os campos comuns (e opcionalmente, associados a eventos) em uma classe base para fazer referência os controles declarados em uma página da Web. Por causa do ASP.NET código geração de modelo, se definida os campos em uma classe de base sem usar esse atributo, na compilar time novas definições de membro seriam geradas para os controles declarados em página da Web (dentro de um stub de classe parcial separado) e seu cenário desejado não funcionaria. Mas se você usar o CodeFileBaseClass atributo para associar a classe base da página e fazer sua classe parcial (seu nome está atribuído para o Inherits atributo e seu arquivo de fonte é citado pela CodeFile atributo) herdam da classe base, os campos na classe base será capazes de fazer referência os controles na página após a geração de código.

  • CodePage
    Indica o valor do esquema de codificação usado para a resposta. O valor é um número inteiro que serve sistema autônomo uma ID para o esquema de codificação. Para obter uma lista de possíveis CodePage As iDs, consulte o Encoding classe.

  • CompilationMode
    Define se a página deve ser compilada, usando uma seqüência de caracteres que especifica uma dentre várias opções enumeradas. O valor padrão é Always, portanto, páginas .aspx são compiladas por padrão. Para obter detalhes, consulte o CompilationMode enumeração.

  • CompilerOptions
    Uma seqüência de caracteres que contém opções de compilador usadas para compilar a página. No Visual Basic e translation from VPE for Csharp, isso é uma sequência de opções de linha de comando do compilador. Para obter mais informações sobre opções do compilador, consulte Opções do Compilador C# ou Compilador do Visual Basic.

  • ContentType
    Define o tipo de conteúdo HTTP da resposta sistema autônomo um tipo de MIME padrão. Oferece suporte a qualquer seqüência de caracteres de tipo de conteúdo HTTP válido. Para uma lista dos valores possíveis, procure por MIME in the Biblioteca MSDN.

  • Culture
    Indica a configuração de cultura para a página. O valor desse atributo deve ser uma ID de cultura válida. Observe que o LCID e Culture atributos são mutuamente exclusivo; se você usar um desses atributos, você não pode usar o Outros na mesma página. Para obter mais informações sobre valores de cultura possíveis, consulte o CultureInfo classe.

  • Debug
    Indica se a página deve ser compilada com símbolos de depurar. true Se a página deve ser compilada com símbolos de depurar; caso contrário, false. Porque essa configuração afeta o desempenho, você só deve conjunto o atributo para true durante o desenvolvimento.

  • Description
    Fornece uma descrição de texto da página. Este valor é ignorado pelo analisador ASP.NET.

  • EnableEventValidation
    Permite que a validação de eventos em cenários de postback e retorno de chamada. true Se os eventos estão sendo validadas; caso contrário, false. O padrão é true.

    Validação do evento página reduz o risco de não autorizadas de solicitações de postback e retornos de chamada. Quando o enableEventValidation propriedade estiver definida como trueO ASP.NET permite que somente os eventos que podem ser disparados no controle durante uma solicitação de postback ou de retorno de chamada. Com esse modelo, um controle registra seus eventos durante o renderização e, em seguida, valida os eventos durante a manipulação de POST ou de retorno de chamada. Todos os controles orientados a eventos no ASP.NET usam esse recurso por padrão.

    É altamente recomendável você não desativar a validação do evento. Antes de desativar a validação do evento, você deve ter certeza que nova postagem foi possível construir e que teria um efeito não intencional no seu aplicativo.

  • EnableSessionState
    Define os requisitos de estado de sessão para a página. true Se ativados; o estado da sessão ReadOnly Se o estado de sessão pode ser leitura, mas não alterados; caso contrário, false. O padrão é true. Esses valores são sem diferenciação de maiúsculas e minúsculas. Para obter mais informações, consulte Visão geral sobre Estado de sessão ASP.NET.

  • EnableTheming
    Indica se os temas são usados na página. true Se os temas estiverem usada; caso contrário, false. O padrão é true.

  • EnableViewState
    Indica se o estado de exibição é mantido entre as solicitações de página. true Se o estado de exibição for mantida; caso contrário, false. O padrão é true.

  • EnableViewStateMac
    Indica que ASP.NET deve executar uma verificação de autenticação de computador (MAC) no estado de exibição da página quando a página é remetida de volta do cliente. true Se estado de exibição deve estar MAC marcada; caso contrário, false. O padrão é true.

    ObservaçãoObservação:

    Um MAC do estado de exibição é uma versão criptografada da variável oculta estado de exibição da página é conduzido a quando enviadas para o navegador. Quando você conjunto esse atributo para true, o estado de exibição criptografado é verificado para verificar que não tenha sido adulterado no cliente. Observe que a configuração desse atributo como true afeta o desempenho, porque o valor da variável deve ser descriptografado e criptografado para cada processamento da página.

  • ErrorPage
    Define um destino URL para redirecionamento se ocorrer uma exceção sem tratamento de página.

  • Explicit
    Determina se a página é compilada usando o Visual Basic Option Explicit modo. true indica que a opção de compilar explícita do Visual Basic é habilitada e que todas as variáveis devem ser declaradas usando um Dim, Private, Public, ou ReDim demonstrativo; caso contrário, false. O padrão é false.

    ObservaçãoObservação:

    Esse atributo é ignorado por idiomas diferentes do Visual Basic. Além disso, essa opção é definida como true no arquivo de configuração computador.config. Para obter mais informações, consulte Arquivos de configuração do computador.

  • Inherits
    Define uma classe code-behind da página herdar. Isso pode ser qualquer classe derivada do Page classe. Este atributo é usado com o CodeFile atributo, que contém o caminho para o arquivo de fonte para o código - behind classe. The Inherits o atributo é caso - sensíveis ao usar translation from VPE for Csharp sistema autônomo o linguagem da página, e caso - minúsculas ao usar o Visual Basic sistema autônomo o linguagem da página.

    Se o Inherits atributo não contém um namespace, o ASP.NET verifica se o ClassName atributo contém um espaço para nome. Nesse caso, o ASP.NET tenta carregar da classe mencionada no Inherits atributo usando o namespace das ClassName atributo. (Isso pressupõe que o Inherits atributo e o ClassName atributo ambas usar o mesmo espaço para nome.)

    Para obter mais informações sobre classes code-behind, consulte Modelo de código de página Web do ASP.NET.

  • Language
    Especifica a linguagem usada durante a compilação de renderização embutido todos os (< % e < % = %>) e blocos de declaração dentro da página de código. Valores podem representar qualquer linguagem compatível com .NET estrutura, incluindo Visual Basic, translation from VPE for Csharp ou JScript. Apenas um linguagem pode ser usado e especificado por página.

  • LCID
    Define a localidade identificador para a página de Web Forms.

    ObservaçãoObservação:

    O ID de localidade é um valor de 32 bit que define uma localidade. O ASP.NET usa a localidade padrão do servidor Web, a menos que você especifique uma localidade diferente para uma página de Web Forms usando esse atributo. Observe que o LCID e Culture atributos são mutuamente exclusivo; se você usar um desses atributos, você não pode usar o Outros na mesma página. Para obter mais informações sobre as localidades, procure o Biblioteca MSDN.

  • LinePragmas
    Determina se o tempo de execução deve gerar pragmas de linha no código-fonte. Estas são opções de compilador que são usadas com freqüência por ferramentas de depuração para marcar locais específicos em um arquivo de fonte. true Se os pragmas de linha devem ser gerados; caso contrário, false.

  • MaintainScrollPositionOnPostback
    Indica se deve retornar o usuário para a posição no navegador cliente mesma após o postback. true Se os usuários devem ser retornados para a mesma posição; caso contrário, false. O padrão é false.

    ObservaçãoObservação:

    Os desenvolvedores podem definir esse atributo para todas as páginas, definindo o maintainScrollPostitionOnPostback atributo (Observe que é sensível a diferenciar diferenciar maiúsculas de minúsculas em arquivos de configuração) sobre o <pages> elemento do arquivo Web.config.

  • MasterPageFile
    Define o caminho para a página mestra para a página de conteúdo ou a página mestra aninhada. Dá suporte a caminhos relativos e absolutos.

  • ResponseEncoding
    Indica o nome do esquema de codificação usado para a resposta HTTP com o conteúdo da página. O valor atribuído a esse atributo é um nome válido de codificação. Para obter uma lista de possíveis nomes de codificação, consulte o Encoding classe. Você também pode chamar o GetEncodings método para obter uma lista de identificações e nomes de codificação possíveis.

  • SmartNavigation
    Indica se a página oferece suporte o recurso Navegação SMART do Internet Explorer 5.5 ou posterior. true Se a navegação SMART estará habilitada; caso contrário, false. O padrão é false.

    You can also set the SmartNavigation property for the page in code, but in general you should set it using the attribute with the @ Page directive. Para obter mais informações sobre como esse recurso melhora a experiência do usuário de navegação em páginas da Web, consulte o SmartNavigation propriedade.

  • Src
    Especifica um caminho para um arquivo de fonte que contém o código que é vinculado à página. No vinculado arquivo de origem, você pode optar por incluir lógica de programação para a página em uma classe ou em declaração de blocos de código.

    Você pode usar o Src atributo vincular criar provedores para a página. Para mais informações, consulte a classe BuildProvider. Além disso, em versões do ASP.NET anteriores à versão 2.0, a Src atributo foi usado sistema autônomo uma maneira alternativa para vincular um arquivo code-behind para uma página. No ASP.NET 2.0, a melhor abordagem para vincular um arquivo de fonte de code-behind para uma página é usar o Inherits atributo para especificar uma classe, juntamente com o CodeFile atributo para especificar o caminho para o arquivo de fonte para a classe.

  • Strict
    Indicates that the page should be compiled using the Visual Basic Option Strict mode. true Se Option Strict é ativado; caso contrário, false. O padrão é false.

    ObservaçãoObservação:

    Esse atributo é ignorado por idiomas diferentes do Visual Basic.

  • StyleSheetTheme
    Especifica um identificador de tema válido para usar na página. Quando o StyleSheetTheme o atributo é conjunto, controles individuais podem substituir o estilísticas conjunto tings contidos em um tema. Assim, um tema pode fornecer uma aparência geral para um site, enquanto as configurações contidas no StyleSheetTheme atributo permitem que você personalize configurações específicas de uma página e seus controles individuais.

  • TargetSchema
    Especifica o nome de um esquema que valida o conteúdo da página. Isso serve apenas uma finalidade descritiva; nenhuma validação real é realizada e o atributo é ignorado pelo analisador.

  • Theme
    Especifica um identificador de tema válido para usar na página. Quando o Theme atributo está definido sem usar o StyleSheetTheme atributo, ela substitui as configurações de estilo individuais em controles, permitindo que você criar uma aparência unificada e consistente em uma página.

  • Title
    Especifica um título para a página é renderizada dentro do HTML de <title> Rótulos na resposta. O título também pode ser acessado por meio de programação sistema autônomo uma propriedade da página. Para obter detalhes, consulte o Title propriedade.

  • Trace
    Indica se o rastreamento está habilitado. true Se o rastreamento está ativado; caso contrário, false. O padrão é false. Para obter mais informações, consulte Visão geral do rastreamento no ASP.NET.

  • TraceMode
    Indica como as mensagens de rastreamento estão a ser exibido para a página quando o rastreamento está habilitado. Os valores possíveis são SortByTime e SortByCategory. O padrão, quando o rastreamento está habilitado, é SortByTime. Para obter mais informações sobre rastreamento, consulte Visão geral do rastreamento no ASP.NET.

  • Transaction
    Indica se as transações suporte na página. Os valores possíveis são Disabled, NotSupported, Supported, Required, e RequiresNew. O padrão é Disabled.

  • UICulture
    Especifica a configuração de cultura de interface do usuário a ser usado para a página. Oferece suporte a qualquer valor de cultura de interface de usuário válido.

  • ValidateRequest
    Indica se a solicitação de validação deve ocorrer. If true, solicitação de validação verifica todos os dados em relação a uma lista de valores possivelmente perigosos embutido em código de entrada. Se ocorrer uma correspondência, um HttpRequestValidationException exceção é lançada. O padrão é true.

    Esse recurso é ativado no arquivo de configuração do computador (Machine.config). Você pode desativá-la em seu arquivo de configuração do aplicativo (Web.config) ou na página definindo este atributo como false.

    ObservaçãoObservação:

    Esse recurso ajuda a reduzir o risco de ataques de scripts entre sites para páginas simples e aplicativos ASP.NET. Um aplicativo que não valida corretamente a entrada do usuário pode sofrer de muitos tipos de ataques de entrada malformados, inclusive cross site scripting e ataques de injeção de Microsoft SQL servidor. Não há nenhum substituto para avaliar com cuidado todos os formulários de entrada em um aplicativo e certificando-se de que serem adequadamente validados ou codificados, ou que o aplicativo é escape antes para manipulação de dados ou enviar informações ao cliente.

  • ViewStateEncryptionMode
    Determina como o estado de exibição é criptografado, com três valores enumerados possíveis: Auto, Always, ou Never. O padrão é Auto, que significa que o estado de exibição será criptografado se solicitar um controle individual. Para obter mais informações, consulte a enumeração ViewStateEncryptionMode.

  • WarningLevel
    Indica o nível de aviso do compilador no qual você deseja que o compilador para tratar avisos sistema autônomo erros, anulando, assim, compilação da página. Níveis de aviso possíveis são 0 a 4. Para obter mais informações, consulte a propriedade WarningLevel.

Comentários

Essa diretiva pode ser usada apenas em páginas de Web Forms. You can include only one @ Page directive per .aspx file. Further, you can define only one Language attribute per @ Page directive, because only one language can be used per page. Como a mais comumente usados são fornecidos valores padrão para a maioria dos atributos no código-fonte ou nos arquivos de configuração, geralmente é desnecessário adicionar um grande conjunto de atributos para a diretiva. Em geral, você deve adicionar o conjunto mínimo de atributos necessários para especificar os recursos desejados para uma página. Se houver um atributo comum que você deseja aplicar a todas as páginas, por exemplo, se você quiser ativar o rastreamento em todas as páginas, considere habilitação do recurso no arquivo Web.config em vez de adicionar o Trace o atributo a cada página individual.

ObservaçãoObservação:

O @ Page directive has a number of attributes in common with other directives that apply to an entire source file, such as the @ Controle directive (used in .ascx files for Web user controls) and the @ Mestre directive (used in .master files for master pages).

To define multiple attributes for the @ Page directive, separate each attribute/value pair with a single space. Para um atributo específico, não inclua um espaço em ambos os lados do sinal de igual (=) que conecta o atributo com o seu valor. Para obter um exemplo, consulte a seção de exemplo deste tópico.

Navegação SMART é um recurso ASP.NET suportado no Internet Explorer 5.5 e posteriores navegadores. Ele permite que uma página a ser atualizado, mantendo posição de rolar e o foco do elemento entre navegações, fazendo com que uma única página sejam armazenadas no histórico do navegador e sem a cintilação comuns associados ao atualizar uma página da Web. Navegação SMART é melhor usada com páginas ASP.NET que exigem postagens freqüentes, mas com conteúdo visual que não é alterado significativamente no retorno. Considere isso cuidadosamente ao decidir se deve conjunto esse atributo para true.

Quando o AspCompat atributo é definido como true para uma página, se você usar um construtor para criar um componente COM antes que a solicitação seja agendada, ele será executado em um segmento de apartment multithreaded (MTA). Isso faz com que significativo degradação de desempenho do servidor Web. Para evitar esse problema, criar componentes COM somente de dentro de uma a Page eventos (sistema autônomo Page_Load, Page_Inite assim por diante) ou um da Page métodos. Não deixe também que sistema autônomo objetos não são criados no time de construção da página.

O exemplo de código a seguir demonstra a maneira recomendada para criar uma instância de um objeto COM em uma página com AspCompat ativado.

<%@ Page AspCompat="true" language="C#" %>
<script runat="server" >

MyComObject comObj;

public void Page_Load(){
   // Use comObj here when the code is running on the STA thread pool.
   comObj = New MyComObject();
   // Do something with the combObj object.
}
<%@ Page AspCompat="true" language="VB" %>
<script runat="server" >

    Dim comObj As MyComObject 

    Public Sub Page_Load()
     'Use comObj here when the code is running on the STA thread pool.
     comObj = New MyComObject()
     ' Do something with the combObj object.
    End Sub
</script>
ObservaçãoObservação:

Adicionando um @ Master diretiva para uma página mestra não permite que você use a mesma declaração de diretiva em páginas que dependem do mestre. Em vez disso, use o <páginas > elemento para definir diretivas de página globalmente.

Exemplo

O exemplo de código a seguir instrui o compilador de página ASP.NET para usar o Visual Basic sistema autônomo o linguagem de código do lado do servidor para a página e define o padrão HTTP MIME ContentType atributo transmitido para o cliente "text/xml".

<%@ Page Language="VB" ContentType="text/xml" %>

Consulte também

Referência

Sintaxe diretiva 

@ Controle

@ Mestre

Outros recursos

Sintaxe da página ASP.NET