@ Página

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

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

Atributos

  • Async
    Torna a página um manipulador assíncrono (isto é, ela faz com que a página para usar uma implementação de IHttpAsyncHandler para processar solicitações).

    O padrão é false.

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

    O valor deve ser um inteiro.

    Para obter mais informações, consulte a propriedade AsyncTimeout.

  • AspCompat
    Quando definido como true, que permite que a página a ser executado em um segmento de single-threaded apartment (STA). Isso permite que a página chamar componentes STA, como, por exemplo, um componente desenvolvido com o Microsoft Visual Basic 6.0. A configuração desse atributo true também permite que a página chamar componentes versão 1.0 do com+ que exigem acesso não gerenciado Active Server Pages (ASP) interna objetos. Esses são acessíveis através do ObjectContext objeto ou o OnStartPage método. O padrão é false.

    Observação

    A configuração desse atributo true pode causar o desempenho da 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. trueSe a vinculação automática de eventos está ativada. 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. trueSe o buffer de página estiver 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 da classe para a página compilada baseia-se no nome de arquivo da página e usa o namespace padrão ASP. Se um valor para o ClassName atributo for especificado sem um espaço para nome completo, em seguida, o namespace ASP é usado, combinado com o nome da classe especificada para criar um nome de classe totalmente qualificado.

    Outra página pode fazer referência a nome da classe atribuído à primeira página, usando o @ Reference diretiva.

    Observaçã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ê pode precompilar seu site com a proteção de origem habilitada, a classe de página code-behind não está localizada no mesmo assembly como a classe de página. aspx.Portanto, a referência de classe no arquivo code-behind não irá funcionar.Para obter mais informações sobre pré-compilação, consulte ASP.NET Precompilation Overview.

  • ClientIDMode
    Especifica o algoritmo usar para gerar ClientID valores para controles. O valor padrão é Predictable. O valor padrão para controles é Inherit. Portanto, o algoritmo padrão para controles em uma página é determinado pelo ClientID a configuração da página. Um valor diferente do padrão pode ser definido no páginas elemento do arquivo Web. config. Para obter mais informações sobre os algoritmos, consulte o ClientIDMode classe.

  • ClientTarget
    Indica o agente de usuário de destino (normalmente, um navegador da Web, como o Microsoft Internet Explorer) para o qual o ASP.Controles de servidor NET devem processar o conteúdo. Esse valor pode ser qualquer alias válido conforme definido dentro de <clientTarget> seção do arquivo de configuração. do aplicativo Para obter mais informações, consulte a propriedade ClientTarget.

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

    Esse atributo é usado para projetos de aplicativo da Web. O CodeFile atributo é usado para projetos de site da Web. Para obter mais informações sobre tipos de projeto de Web em Visual Studio, consulte Projetos de aplicativos Web versus projetos de sites da Web.

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

    Esse atributo é usado para projetos de site. O CodeBehind atributo é usado para projetos de aplicativo da Web. Para obter mais informações sobre tipos de projeto de Web em Visual Studio, consulte Projetos de aplicativos Web versus projetos de sites da Web.

  • 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 ele é usado o CodeFile atributo também deve estar presente. Use este atributo quando desejar implementar um cenário compartilhado, onde você definir campos comuns (e opcionalmente, associado eventos) em uma classe base para fazer referência os controles declarados em uma página da Web. Por causa do ASP.Modelo de geração do código de rede, se os campos são definidos na classe base sem usar esse atributo, novas definições de membro de tempo na compilação seriam geradas para os controles declarados na 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 de atributo para associar a classe base com a página e fazer sua classe parcial (seu nome é atribuído ao Inherits atributo e seu arquivo de origem é citado pelo 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 como uma identificação para o esquema de codificação. Para obter uma lista de possíveis CodePage IDs, consulte o Encoding classe.

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

  • CompilerOptions
    Uma seqüência de caracteres contendo opções do compilador usadas para compilar a página. No C# e Visual Basic, esta é uma seqüê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 como um tipo MIME padrão. Suporta qualquer seqüência de caracteres de tipo de conteúdo HTTP válida. Para obter uma lista dos valores possíveis, procure por MIME na Biblioteca MSDN.

  • Culture
    Indica a configuração de cultura para a página. O valor deste atributo deve ser uma identificação de cultura válida. Observe que o LCID e Culture atributos são mutuamente exclusivos; Se você usar um desses atributos, é possível usar o outro na mesma página. Para obter mais informações sobre, consulte o Culture propriedade e o CultureInfo classe.

  • Debug
    Indica se a página deve ser compilada com símbolos de depuração. trueSe a página deve ser compilada com símbolos de depuração; Caso contrário, false. Como esta configuração afeta o desempenho, você só deve definir o atributo true durante o desenvolvimento.

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

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

    Validação do evento de página reduz o risco de não autorizadas de solicitações de postback e retornos de chamada. Quando o enableEventValidation for definida como true, ASP.NET permite que somente os eventos que podem ser disparados no controle durante uma solicitação de postback ou retorno de chamada. Com esse modelo, um controle registra seus eventos durante o processamento e, em seguida, valida os eventos durante a manipulação de postagem ou de retorno de chamada. Todos os controles orientada a eventos no ASP.NET use 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. trueSe o estado de sessão estiver habilitado; ReadOnlySe o estado da sessão pode ser lido mas não alterado; Caso contrário, false. O padrão é true. Esses valores diferenciam maiúsculas de 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. trueSe os temas são usados; Caso contrário, false. O padrão é true.

  • EnableViewState
    Especifica se o estado de exibição é mantido em solicitações de página. Esse valor é true se o estado de exibição é mantido, ou false se o estado de exibição não é mantido. O padrão é true.

    Mesmo se essa propriedade é definida como true, estado de exibição não será mantido para um controle se alguma das seguintes condições se aplicar:

    Para obter mais informações sobre o estado de exibição e estado do controle, consulte o Control.EnableViewState propriedade.

  • EnableViewStateMac
    Indica que o ASP.NET deve verificar os códigos de autenticação de mensagem (MAC) no estado de exibição da página quando a página é remetida de volta a partir do cliente. trueSe o estado de exibição deve ser MAC marcada; Caso contrário, false. O padrão é true.

    Um MAC do estado de exibição é uma versão criptografada da variável oculta no qual o estado de exibição da página persiste quando é enviada ao navegador. O MAC é usado para verificar se o estado de exibição não foi adulterado no cliente.

    Observação

    Este atributo nunca deve ser definido como false em um site da Web de produção.

  • ErrorPage
    Define um URL de destino para o redirecionamento se ocorrer uma exceção não tratada página. Para obter mais informações, consulte a propriedade ErrorPage.

  • 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 está habilitada 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.

    Observação

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

  • Inherits
    Define uma classe code-behind para a página herdar. Isso pode ser qualquer classe que deriva do Page classe. Esse atributo é usado com o CodeFile atributo, que contém o caminho para o arquivo de origem para a classe de code-behind. O Inherits atributo está diferenciando maiúsculas de minúsculas ao usar C# como o idioma da página e diferencia maiúsculas de minúsculas ao usar o Visual Basic como o idioma da página.

    Se a atributo deInherits não contém um namespace, o ASP.NET verifica se a ClassName atributo contém um espaço para nome. Nesse caso, ASP.NET tenta carregar a classe referenciada na Inherits de atributo usando o namespace da ClassName atributo. (Isso pressupõe que o Inherits atributo e o ClassName atributo ambos usam 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 o idioma usado ao compilar todo o processamento de embutido (% e < % = % >) e blocos de declaração dentro da página de código. Valores podem representar qualquer.Linguagem com suporte do NET Framework, incluindo Visual Basic, C# ou JScript. Somente um idioma pode ser usado e especificado por página.

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

    Observação

    O identificador de localidade é um valor de 32 bits que define exclusivamente uma localidade.ASP.NET usa a localidade padrão do servidor Web, a menos que você especifique uma localidade diferente para uma página Web Forms usando esse atributo.Observe que o LCID e Culture atributos são mutuamente exclusivos; Se você usar um desses atributos, é possível usar o outro 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 do compilador usadas com freqüência pelas ferramentas de depuração para marcar locais específicos em um arquivo de origem. trueSe os pragmas de linha devem ser gerados; Caso contrário, false.

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

    Observação

    Os desenvolvedores podem definir esse atributo para todas as páginas, definindo a maintainScrollPostitionOnPostback atributo (Observe que é diferencia 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. Suporta caminhos relativos e absolutos. Para obter mais informações, consulte a propriedade MasterPageFile.

  • MetaDescription
    Conjuntos de MetaDescription propriedade. Se a marcação da página também inclui uma "Descrição" metaelemento, o valor de @ Page diretiva substitui o valor na marcação.

  • MetaKeywords
    Conjuntos de MetaKeywords propriedade. Se a marcação da página também inclui um "keywords" metaelemento, o valor de @ Page diretiva substitui o valor na marcação.

  • ResponseEncoding
    Indica o nome do esquema de codificação usado para a resposta HTTP que contém 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 nomes de codificação possíveis, consulte o Encoding classe. Você também pode chamar o GetEncodings método para obter uma lista de possíveis nomes de codificação e identificações.

  • SmartNavigation
    Indica se a página suporta o recurso navegação inteligente do Internet Explorer 5.5 ou posterior. trueSe a navegação inteligente está habilitada; Caso contrário, false. O padrão é false.

    No ASP.NET versão 2.0 e versões posteriores, o SmartNavigation propriedade é obsoleta. Use o SetFocus método e a MaintainScrollPositionOnPostback() propriedade em vez disso.

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

    Você pode usar o Src atributo para vincular compilação provedores para a página. Para mais informações, consulte a classe BuildProvider. Além disso, nas versões do ASP.NET anteriores à versão 2.0, o Src atributo foi usado como uma maneira alternativa para vincular um arquivo code-behind para uma página. No ASP.NET 2.0, a abordagem preferencial para vincular um arquivo de origem 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 origem para a classe.

  • Strict
    Indica que a página deve ser compilada usando o Visual Basic Option Strict modo. trueSe Option Strict está ativado. Caso contrário, false. O padrão é false.

    Observação

    Esse atributo é ignorado por outros idiomas além do Visual Basic.

  • StyleSheetTheme
    Especifica um identificador de tema válido para usar na página. Quando o StyleSheetTheme atributo está definido, controles individuais podem substituir as configurações estilísticas contidas em um tema. Assim, um tema pode fornecer uma aparência geral para um site, enquanto as configurações contidas no StyleSheetTheme atributo permitem personalizar as 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 é executada 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. Para obter mais informações, consulte a propriedade Theme.

  • Title
    Especifica um título para a página que é processado no código HTML <title> marcas na resposta. O título também pode ser acessado programaticamente como uma propriedade da página. Para obter detalhes, consulte o Title propriedade.

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

  • TraceMode
    Indica como mensagens de rastreamento são a ser exibida para a página quando o rastreamento está habilitado. 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 há suporte para transações COM+ na página. Possible values are Disabled, NotSupported, Supported, Required, and RequiresNew. O padrão é Disabled.

  • UICulture
    Especifica a configuração de cultura de interface (UI) do usuário para a página. Suporta qualquer valor válido de cultura da interface do usuário. Para obter mais informações, consulte a propriedade UICulture.

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

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

    Observação

    Essa funcionalidade ajuda a reduzir o risco de ataques de script entre sites para páginas simples e ASP.NET applications.Um aplicativo que não valida corretamente a entrada de usuário pode sofrer de muitos tipos de ataques de entrada malformados, inclusive o cross site scripting e ataques de injeção de Microsoft SQL Server.Não há nenhum substituto para avaliar cuidadosamente a todos os formulários de entrada em um aplicativo e certificando-se de que eles corretamente são validados ou codificados ou que o aplicativo é escape antes para a manipulação de dados ou enviar informações ao cliente.

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

  • ViewStateMode
    Especifica o ViewStateMode valor da propriedade entrará em vigor para um controle quando o ViewStateMode é de propriedade do controle Inherit. O padrão ViewStateMode o valor de uma página é Enabled.

    O ViewStateMode e EnableViewState propriedades determinam se o estado de exibição é mantido para controles em uma página. Para obter mais informações, consulte o EnableViewState propriedade e o ViewStateMode propriedade.

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

Comentários

Essa diretiva pode ser usada somente em páginas Web Forms. Você pode incluir apenas uma @ Page diretiva por todos os arquivos. aspx. Além disso, você pode definir apenas uma Language atributo por @ Page diretiva, porque somente um idioma pode ser usado por página. Porque os mais usados padrão são fornecidos valores para a maioria dos atributos no código fonte ou em arquivos de configuração, geralmente é desnecessário adicionar um grande conjunto de atributos para a diretiva. Geralmente, você deve adicionar o conjunto mínimo de atributos necessários para especificar os recursos que você deseja para uma página. Se houver um atributo comum que você deseja aplicar a todas as páginas, por exemplo, se você deseja ativar o rastreamento em todas as páginas, considere ativar o recurso no arquivo Web. config em vez de adicionar o Trace atributo para cada página individual.

Observação

O @ Page diretiva tem um número de atributos em comum com outras diretivas que se aplicam a um arquivo de origem inteiro, como o @ Control diretiva (usada em arquivos. ascx controles de usuário da Web) e o @ Master diretiva (usada em páginas mestras arquivos. master).

Para definir vários atributos para o @ Page diretiva, separe cada par de valor do atributo com um único espaço. Para um atributo específico, não inclua um espaço nos dois lados do sinal de igual (=) que conecta o atributo com o seu valor. Por exemplo, consulte a seção exemplo neste tópico.

Navegação inteligente é um aplicativo ASP.Recurso NET suportado no Internet Explorer 5.5 e posteriores navegadores. Ele permite que uma página a ser atualizado enquanto mantém a posição de rolagem e o foco do elemento entre as navegações, causando uma única página sejam armazenadas no histórico do navegador e sem oscilação comuns associados com a atualização de uma página da Web. Navegação inteligente é melhor usada com o ASP.NET que exige freqüente de postbacks, mas com conteúdo visual que não é alterado de forma significativa a retornar. Considere isso cuidadosamente ao decidir se deve definir esse atributo para true.

Quando o AspCompat atributo está 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 thread MTA (multithreaded apartment). Isso faz com que a degradação de desempenho do servidor Web significativa. Para evitar esse problema, criar componentes COM, somente a partir de dentro de uma da Page eventos (como Page_Load, Page_Inite assim por diante) ou uma da Page métodos. Não se esqueça também que os objetos não são criados no tempo 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ção

Adicionando um @ Master diretiva para uma página mestra não permite que você use a mesma declaração diretiva nas 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 ASP.Compilador NET personalizada para usar o Visual Basic como o idioma de código do lado do servidor para a página e define o padrão HTTP MIME ContentType atributo transmitido ao cliente para "text/xml".

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

Consulte também

Referência

Texto Sintaxe de modelo de diretiva

@ Control

@ Master

Outros recursos

ASP.NET Page Syntax