Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

@ 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"...] %>

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.

Note Note

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. true Se 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. true Se 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.

Note Note

É 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. true Se 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. true Se 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. true Se 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 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 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:

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. true Se 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 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. true indica 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.

Note Note

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 Arquivos de configuração ASP.NET.

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.

Note Note

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. true Se 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. true Se os usuários devem ser retornados para a mesma posição; Caso contrário, false. O padrão é false.

Note Note

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. true Se 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. true Se Option Strict está ativado. Caso contrário, false. O padrão é false.

Note Note

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. true Se 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.

Note Note

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.

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.

Note Note

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 para controles de usuário da Web) e o @ Master (usada em arquivos. Master para páginas mestras) de diretiva.

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.
}
NoteNote

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.

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" %>
Mostrar: