@ Page

[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 específicos de página (arquivo. aspx) usados pelo processo do 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 é, ele faz com que a página para usar uma implementação do 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, permite que a página 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 COM + versão 1.0 que exigem acesso a objetos internos de Active Server Pages (ASP) não gerenciado. 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 podem causar degradar o desempenho da sua página.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 ASP.NET Web Server Control Event Model.

• 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 page 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, 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á localizado 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 Web Site 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 pela ClientID a configuração da página. Um valor padrão diferente 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 do <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 aplicativos 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 Site Visual Studio.

• CodeFile
  Especifica um caminho para o arquivo referenciado code-behind da página. Esse atributo é usado em conjunto com o Inherits atributo para associar um arquivo de origem code-behind 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 aplicativos da Web. Para obter mais informações sobre tipos de projeto de Web em Visual Studio, consulte Projetos de aplicativos Web versus projetos de Site Visual Studio.

• 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 deve estar presente. Use este atributo quando desejar implementar um cenário compartilhado, onde você define 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 NET, se você definiu os campos na classe base sem usar esse atributo, na compilação novas definições de membro de tempo 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 da 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 identificações, consulte a 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, as páginas. aspx são compiladas por padrão. Para obter detalhes, consulte a 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, isso é 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 Visual Basic compilador de linha de comando.

• 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, você não pode 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 compilador do 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 propriedade estiver definida como true, ASP.NET permite que somente os eventos que podem ser disparados no controle durante uma solicitação de postback ou um 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 da sessão está ativado. 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 ASP.NET Session State Overview.

• 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 qualquer uma das seguintes condições se aplicam:

  • O controle EnableViewState propriedade estiver definida como false.

  • O controle ViewStateMode propriedade estiver definida como Disabled ou o controle herda a Disabled valor.

  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 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 de uma página persiste quando é enviada ao navegador. O MAC é usado para verificar se o estado de exibição não foi adulterado no cliente.

  Security Note
  Este atributo nunca deve ser definido como false em um site 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 é 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.

  Observação

  Esse atributo é ignorado pelo idiomas diferentes de Visual Basic.Além disso, essa opção é definida como true no arquivo de configuração Machine. config.Para obter mais informações, consulte ASP.NET Configuration Files.

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

  Se a Inherits atributo não contém um espaço para nome, ASP.NET verifica se o 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 namespace.)

  Para obter mais informações sobre classes code-behind, consulte ASP.NET Web Page Code Model.

• Language
  Especifica o idioma usado ao compilar todos os embutidos de renderização (% e < % = % >) e declaração blocos dentro da página de código. Valores podem representar qualquer.Idiomas com suporte a 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 um local diferente para uma página de formulários da Web usando este atributo.Observe que o LCID e Culture atributos são mutuamente exclusivos; Se você usar um desses atributos, você não pode 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 que são freqüentemente usadas por 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 ele é 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" meta elemento, 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" meta elemento, 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 um 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 identificações e nomes de codificação possíveis.

• 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 provedores de compilação 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 a 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 OptionStrict modo. trueSe Option Strict está ativado. Caso contrário, false. O padrão é false.

  Observação

  Esse atributo é ignorado pelo idiomas diferentes de 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 na 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 é feita 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 a 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 ASP.NET Tracing Overview e o Trace propriedade.

• TraceMode
  Indica como mensagens de rastreamento sã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 estiver ativado, é SortByTime. Para obter mais informações sobre rastreamento, consulte ASP.NET Tracing Overview.

• 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 a ser usado 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 toda entrada de dados em uma lista codificada de valores possivelmente perigosos. Se houver 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 seguros.Um aplicativo que não valida corretamente a entrada do 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 com cuidado 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 sofre escape antes para manipulação de dados ou enviar informações para o cliente.

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

• ViewStateMode
  Especifica o ViewStateMode valor da propriedade que entrará em vigor para um controle quando o ViewStateMode é de propriedade do controle Inherit. O padrão ViewStateMode 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, assim, anulando 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.

Remarks

Essa diretiva pode ser usada somente em páginas de Web Forms. Você pode incluir apenas uma @ Page diretiva por arquivo. aspx. Além disso, você pode definir apenas uma Language de atributo por @ Page diretiva, porque somente um idioma pode ser usado por página. Porque o mais comumente usados padrão são fornecidos valores para a maioria dos atributos, o 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 desejados para uma página. Se não 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 de atributo a cada página individual.

Para definir vários atributos para o @ Page diretiva, separe cada par atributo/valor 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 deste tópico.

Navegação inteligente é um aplicativo ASP.NET recurso suportado no Internet Explorer 5.5 e versões mais recentes. Ele permite que uma página a ser atualizado, mantendo o foco no elemento entre as navegações, fazendo com que 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 e a posição de rolagem. Navegação inteligente é melhor usada com o ASP.NET que exige freqüente 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 segmento de multithreaded apartment (MTA). Isso faz com que a degradação de desempenho do servidor Web significativa. Para evitar esse problema, crie componentes COM, apenas 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 momento da construção de 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 habilitada.

<%@ 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>

Exemplo

O exemplo de código a seguir instrui o ASP.Compilador NET personalizada para usar 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

Reference

Sintaxe de diretiva de modelo de texto

@ Control

@ Master

Other Resources

ASP.NET Page sintaxe