páginas Element (ASP.NET Settings Schema)

  • Artigo

[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 globalmente específicas da página Configurações, como o ASP.NET diretivas para páginas e controles que estão dentro do escopo do arquivo de configuração.

<pages     
   asyncTimeout="number"
   autoEventWireup="[True|False]"
   buffer="[True|False]"
   clientIDMode="[AutoID|Predictable|Static]"
   compilationMode="[Always|Auto|Never]" 
   controlRenderingCompatibilityVersion="[3.5|4.0]"
   enableEventValidation="[True|False]"
   enableSessionState="[True|False|ReadOnly]"
   enableViewState="[True|False]"
   enableViewStateMac="[True|False]"
   maintainScrollPositionOnPostBack="[True|False]" 
   masterPageFile="file path" 
   maxPageStateFieldLength="number" 
   pageBaseType="typename, assembly"
   pageParserFilterType="string" 
   renderAllHiddenFieldsAtTopOfForm="[True|False]"
   smartNavigation="[True|False]"
   styleSheetTheme="string"
   theme="string"
   userControlBaseType="typename"
   validateRequest="[True|False]"
   viewStateEncryptionMode="[Always|Auto|Never]" 
>
   <controls>...</controls>
   <namespaces>...</namespaces>
   <tagMapping>...</tagMapping>
   <ignoreDeviceFilters>...</ignoreDeviceFilters>
</pages>

Attributes and Elements

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Attributes

Atributo

Descrição

asyncTimeout

Opcional TimeSpan atributo.

Especifica o número de segundos para aguardar um manipulador assíncrono concluir durante o processamento assíncrono.

Esse atributo é novo na.NET Framework versão 2.0.

O padrão é "0:00:45" (45 segundos).

autoEventWireup

Opcional Boolean atributo.

Especifica se os eventos da página são habilitados automaticamente. Isso é se wireup evento automática ocorrerá, que significa que o sistema irá anexar automaticamente os métodos de determinada assinatura (Page_Load por exemplo). Para mais informações, consulte ASP.NET Server Control Event Model.

O padrão é True.

buffer

Opcional Boolean atributo.

Especifica se o recurso de URL usa o buffer de resposta.

O padrão é True.

clientIDMode

Especifica o algoritmo usar para gerar ClientID valores para controles. O valor padrão é Predictable. É o valor padrão para controles de Inherit. Portanto, o algoritmo padrão para controles em uma página é determinado pelo ClientIDMode a configuração da página. Um valor diferente do padrão pode ser definido @ Page diretiva da página ou de @ Control diretiva de controle de usuário. Para obter mais informações sobre os algoritmos, consulte ClientIDMode e ASP.NET Control Identification.

compilationMode

Opcional CompilationMode atributo.

Especifica se um aplicativo ASP.NET ou controle deve ser compilado em tempo de execução.

O compilationMode atributo é novo na.NET Framework 2.0. Esse atributo pode ser um dos seguintes valores possíveis. O padrão é Always.

ValorDescrição
Always A página sempre deve ser compilada.
Auto ASP.NET não irá compilar a página, se possível.
Never A página ou controle nunca deve ser dinamicamente compilado. Se uma página contém um bloco de script ou código de construção que requer compilação, ASP.NET retornará um erro e a página não será executado.

controlRenderingCompatibilityVersion

Especifica se controles devem processar HTML como em uma versão anterior do ASP.NET ou a maneira como eles são projetados para fazer na versão atual.

NoteNote
O controlRenderingCompatibilityVersion é novo no ASP.NET 4.A configuração para o número da versão atual tem o mesmo efeito que não a configuração.Em qualquer caso, os controles processam HTML conforme projetado para a versão atual.A versão mais antiga que este atributo pode ser definido como é 3.5.

Para obter mais informações, consulte o PagesSection.ControlRenderingCompatibilityVersion e Control.RenderingCompatibility propriedades.

enableEventValidation

Especifica se páginas e controles validam eventos postback e retorno de chamada. O padrão é True.

enableSessionState

Opcional String atributo.

Especifica os requisitos de estado de sessão para os recursos que estão dentro do escopo do arquivo de configuração.

O enableSessionState atributo pode ser um dos seguintes valores possíveis. O padrão é True.

ValorDescrição
False Indica o estado da sessão é desabilitado.
ReadOnly Indica o estado da sessão não é gravável.
True Indica o estado da sessão está habilitado.

enableViewState

Opcional Boolean atributo.

Especifica se o estado de exibição está habilitado e mantido em solicitações de página.

O padrão é True.

enableViewStateMac

Opcional Boolean atributo.

Especifica se ASP.NET deve executar um código de autenticação de mensagem (MAC) no estado de exibição da página quando a página é remetida voltar do cliente. Se True, o estado de exibição criptografado é verificado para confirmar que ele não foi adulterado no cliente.

O padrão é True.

maintainScrollPositionOnPostBack

Opcional Boolean atributo.

Especifica se deve retornar o usuário para a mesma posição no navegador do cliente quando páginas são postadas no servidor. Se False, o usuário é retornado para a parte superior da página em um postback.

Esse atributo é novo na.NET Framework 2.0.

O padrão é False.

masterPageFile

Opcional String atributo.

Especifica o caminho da página mestra relativo ao arquivo de configuração local. Páginas que possuem o masterPageFile atributo definido como True deve conter um Content controle como o controle de nível superior

Esse atributo é novo na.NET Framework 2.0.

O padrão é uma seqüência vazia ("").

maxPageStateFieldLength

Opcional Int32 atributo.

Especifica o comprimento máximo em caracteres para o campo de estado da página. Se definido como um número positivo, o campo de estado de exibição é enviado para o navegador do cliente é separado em blocos e cada bloco é menor que o tamanho especificado na maxPageStateFieldLength atributo. Se definido como um número negativo, o campo estado de exibição não deve ser separado em partes.

Esse atributo é novo na.NET Framework 2.0.

O padrão é "-1".

pageBaseType

Opcional String atributo.

Especifica a base para usar quando as páginas são autônomas apenas. Isso é substituído pelo inherits atributo em um arquivo autônomo.

O padrão é "System.Web.UI.Page".

pageParserFilterType

Opcional String atributo.

Especifica o nome de tipo de um filtro que é usado pelo ASP.Analisador de rede para determinar se um item é permitido na página em tempo de análise. O filtro deve derivar de PageParserFilter classe.

Esse atributo é novo na.NET Framework 2.0.

O padrão é uma seqüência vazia ("").

renderAllHiddenFieldsAtTopOfForm

Opcional Boolean atributo.

Especifica se todos os campos ocultos gerado pelo sistema são processados na parte superior do formulário.

Esse atributo é novo na.NET Framework 3.5.

O padrão é True.

smartNavigation

Opcional Boolean atributo.

Especifica se a navegação inteligente é habilitada. Navegação inteligente requer o Microsoft Internet Explorer versão 5.5 ou posterior. Quando a navegação inteligente é habilitada, o usuário enfrenta os seguintes benefícios:

  • Piscar navegação é eliminado.

  • Posição de rolagem é mantida entre as páginas.

  • Foco do elemento é mantido entre as páginas.

  • O último estado da página é o estado apenas mantido pelo histórico do navegador.

Esse atributo é novo na.NET Framework 2.0, mas foi preterida em favor do maintainScrollPositionOnPostBack atributo.

O padrão é False.

styleSheetTheme

Opcional String atributo.

Especifica o nome da pasta "tema nomeado" a ser usado para aplicar o tema antes de declarações de controle, em contraste com o atributo de tema que define o tema para aplicar após a declaração de controle.

Esse atributo é novo na.NET Framework 2.0.

O padrão é uma seqüência vazia ("").

theme

Opcional String atributo.

Especifica o nome do tema que é usado para as páginas que estão dentro do escopo do arquivo de configuração. O tema especificado deve existir como um aplicativo ou um tema global. Se o tema não existir, um HttpException exceção é lançada.

Esse atributo é novo na.NET Framework 2.0.

O padrão é uma seqüência vazia ("").

userControlBaseType

Opcional String atributo.

Especifica a base para usar quando as páginas são autônomas apenas.

O padrão é "UserControl".

validateRequest

Opcional Boolean atributo.

Indica que o ASP.NET examina todas as entradas do navegador para dados potencialmente perigosos. Se True, validação de solicitação é executada, comparando a entrada todos os dados para uma lista de valores possivelmente perigosos. Se houver uma correspondência, o ASP.NET gera uma HttpRequestValidationException exceção.

O padrão é True.

viewStateEncryptionMode

Opcional ViewStateEncryptionMode atributo.

Especifica o modo de criptografia de estado de exibição. O ViewStateEncryptionMode propriedade substitui esse atributo, que é definido no arquivo de configuração.

Esse atributo pode ser um dos seguintes valores possíveis.

ValorDescrição
Always Estado de exibição é sempre criptografado.
Auto Estado de exibição é criptografado, se um controle o solicita.
Never Estado de exibição nunca é criptografado, mesmo se um controle o solicita.

Esse atributo é novo na.NET Framework 2.0.

O padrão é Auto.

Child Elements

Elemento

Descrição

controls

Define um conjunto de diretivas de registro e os namespaces onde residem os prefixos da marca.

namespaces

Define um conjunto de diretivas de importação para usar durante a pré-compilação do assembly.

tagMapping

Define uma coleção de tipos marca que são remapeados para outros tipos de marca em tempo de compilação.

ignoreDeviceFilters

Define uma coleção de elementos de dispositivo que o navegador deve ignorar a página é processada. Para mais informações, consulte IgnoreDeviceFilters.

Parent Elements

Elemento

Descrição

configuration

O elemento raiz necessário em cada arquivo de configuração que é usado pelo common language runtime e o.Aplicativos com interatividade de NET.

system.web

Especifica o elemento raiz para o ASP.Definições de configuração de rede em uma configuração de arquivo e contém elementos de configuração que configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.

Remarks

O pages elemento define configurações específicas da página. Esta seção de configuração oferece suporte a configuração de certos ASP.NET diretivas de página e controle globalmente para todas as páginas e controles no escopo do arquivo de configuração. Isso inclui as seguintes diretivas de nível de página, especifique as configurações que são usadas pelos compiladores de página e controle de usuário quando os compiladores processam ASP.NET Web Forms página (. aspx) e arquivos de controle (. ascx) do usuário:

O pages elemento também fornece suporte para mapear tipos de marcas para outros tipos de marca em tempo de execução por meio de tagMapping elemento.

Observação

Adicionando um @ Page diretiva para uma página mestra não permite usar a mesma declaração de diretiva em páginas que dependem do mestre.Em vez disso, use o pages o elemento de configuração globalmente definir diretivas de página.

Configuração padrão

O seguinte padrão pages elemento não está configurado explicitamente no arquivo Machine. config ou no arquivo raiz Web. config. No entanto, é a configuração padrão retornada por um aplicativo. Namespaces e controles são adicionados no arquivo raiz Web. config.

<pages 
   buffer="true" 
   clientIDMode="AutoID" 
   enableSessionState="true" 
   enableViewState="true" 
   enableViewStateMac="true" 
   smartNavigation="false" 
   autoEventWireup="true" 
   pageBaseType="System.Web.UI.Page" 
   userControlBaseType="System.Web.UI.UserControl" 
   validateRequest="true" 
   masterPageFile="" 
   theme="" 
   styleSheetTheme="" 
   maxPageStateFieldLength="-1" 
   compilationMode="Always" 
   pageParserFilterType="" 
   viewStateEncryptionMode="Auto" 
   maintainScrollPositionOnPostBack="false" 
   asyncTimeout="45"
>
   <namespaces>
      <clear />
   </namespaces>
   <tagMapping>
      <clear />
   </tagMapping>
</pages>

Exemplo

O exemplo de código a seguir demonstra como especificar várias configurações de página.

<configuration>
   <system.web>
      <pages buffer="true"
         enableSessionState="true"
         autoEventWireup="true"
         maintainScrollPositionOnPostBack="true"
         masterPageFile = "~/Masters/Page1.master" />
  </system.web>
</configuration>

Element Information

Manipulador de seção de configuração

PagesSection

Membro de configuração

Pages

Page

Locais configuráveis

Machine.config

Web. config de nível de raiz

Web. config de nível de aplicativo

Virtual ou físico directory–level Web. config

Requisitos

Serviços de Informações da Internet da Microsoft (IIS) versões 5.0 ou posteriores

O.NET Framework versões 1.0 ou posteriores

Microsoft Visual Studio 2003 ou posterior

Consulte também

Tasks

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Reference

configuração Element (General Settings Schema)

Controla o elemento para páginas (ASP.NET Settings Schema)

namespaces de elemento para pages (ASP.NET Settings Schema)

tagMapping elemento para páginas (ASP.NET Settings Schema)

System. Web Element (ASP.NET Settings Schema)

@ Page

System.Configuration

System.Web.Configuration

Page

PagesSection

Concepts

ASP.NET Configuration File Hierarchy

Securing Configuration

Other Resources

Configurações gerais (ASP.NET)

ASP.Definições de configuração de rede

Configuring ASP.NET Applications

ASP.NET Configuration API