páginas Element (ASP.NET Settings Schema)

Artigo
05/28/2012

[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. Note 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 @ Page diretiva (@ Page).
O @ Import diretiva (@ Import) por meio de namespaces elemento filho.
O @ Register diretiva (@ Register) por meio de controles de elemento filho.

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

Compartilhar via

páginas Element (ASP.NET Settings Schema)

Attributes and Elements

Attributes

Child Elements

Parent Elements

Remarks

Configuração padrão

Exemplo

Element Information

Consulte também

Tasks

Reference

Concepts

Other Resources

Recursos adicionais