pages Element (ASP.NET Settings Schema)

Artigo
08/04/2011

Globalmente define configurações específicas da página de configuração, como, por exemplo, 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" 
   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>

Atributos e elementos

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

Atributos

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 de página são habilitados automaticamente. Isso é se o wireup automático eventos ocorre, que significa que o sistema irá anexar automaticamente os métodos de determinada assinatura (Page_Load por exemplo). Para obter mais informações, consulte Modelo de eventos de controle do servidor Web ASP.NET. 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 é 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 no @ Page diretiva da página ou do @ Control diretriz de um controle de usuário. Para obter mais informações sobre os algoritmos, consulte ClientIDMode e Identificação de controle do servidor Web ASP.NET.
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 deve sempre ser compilada. Auto ASP.NET não compilar a página, se possível. Never A página ou controle nunca deve ser dinamicamente compilado. Se uma página contiver um bloco de script ou código construir que requer a compilação, o ASP.NET retornará com um erro e a página não será executado.
controlRenderingCompatibilityVersion	Especifica se controles devem processar HTML da maneira que eles fazem em uma versão anterior do ASP.NET ou a maneira como eles são desenvolvidos para fazer na versão atual. Observação O controlRenderingCompatibilityVersion há de novo no ASP.NET 4.A configuração para o número da versão atual tem o mesmo efeito que não defini-la.Em ambos os casos, os controles processam HTML conforme projetado para a versão atual.A versão mais antiga, este atributo pode ser definido como é 3.5. Para obter mais informações, consulte o PagesSection.ControlRenderingCompatibilityVersion e Control.RenderingCompatibility Propriedades.
enableEventValidation	Especifica se as páginas e controles validam os eventos de 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 uma das seguintes possíveis valores. O padrão é True. ValorDescrição False Indica que o estado de sessão está desativado. ReadOnly Indica o estado da sessão não é gravável. True Indica que o estado da sessão é ativado.
enableViewState	Opcional Boolean atributo. Especifica se o estado de exibição é ativado 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 de volta a partir do cliente. Se True, o estado de exibição criptografado é verificado que ele não foi violado 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 relativa ao arquivo de configuração local. Páginas que possuem o masterPageFile atributo definido como True deve conter um Content o controle como o controle de nível superior Esse atributo é novo na.NET Framework 2.0. The default is an empty string ("").
maxPageStateFieldLength	Opcional Int32 atributo. Especifica o comprimento máximo em caracteres para o campo de estado para a página. Se definido como um número positivo, o campo de estado de exibição é enviado ao 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 de estado de exibição não deve ser separado em blocos. 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 do 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. The default is an empty string ("").
smartNavigation	Opcional Boolean atributo. Especifica se a navegação inteligente está habilitada. Navegação inteligente requer Microsoft Internet Explorer versão 5.5 ou posterior. Quando a navegação inteligente está habilitada, o usuário enfrenta os seguintes benefícios: Piscar de navegação é eliminado. A posição de rolagem é mantida entre as páginas. Foco do elemento é mantido entre páginas. O último estado da página é o estado somente mantido pelo histórico do navegador. Esse atributo é novo na.NET Framework 2.0, mas foi substituída em favor do maintainScrollPositionOnPostBack atributo. O padrão é False.
styleSheetTheme	Opcional String atributo. Especifica o nome do "tema nomeado" pasta a ser usado para aplicar o tema antes declarações de controle, em contraste com o atributo de tema que define o tema a ser aplicada após a declaração de controle. Esse atributo é novo na.NET Framework 2.0. The default is an empty string ("").
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. The default is an empty string ("").
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, solicitação de validação é executada, comparando todos os dados de entrada para uma lista de valores possivelmente perigosos. Se ocorrer uma correspondência, o ASP.NET gera uma HttpRequestValidationException exceção. O padrão é True.
viewStateEncryptionMode	Opcional ViewStateEncryptionMode atributo. Especifica o modo de criptografia do 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 solicitá-la. Never Estado de exibição nunca é criptografado, mesmo se um controle solicitá-la. Esse atributo é novo na.NET Framework 2.0. O padrão é Auto.

Elementos filho

Elemento	Descrição
controls	Define um conjunto de diretivas register e os espaços para nome onde residem os prefixos de 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 de marca são remapeados para outros tipos de marcas em tempo de compilação.
ignoreDeviceFilters	Define uma coleção de elementos de dispositivo que o navegador deve ignorar a página é renderizada. Para obter mais informações, consulte IgnoreDeviceFilters.

Elementos pai

Elemento	Descrição
configuration	O elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e a.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 para configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.

Comentários

O pages elemento define configurações de configuração específicas de página. Esta seção de configuração oferece suporte a definiçã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 o ASP.Página de Web Forms da NET (. aspx) e controle de usuário (. ascx) arquivos:

O @ Page diretiva (@ Page).
O @ Import diretiva (@ Import) por meio de namespaces elemento filho.
O @ Register diretiva (@ Register) por meio de controles elemento filho.

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

Observação

Adicionando um @ Page diretiva para uma página mestra não permite que você 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 é o elemento não explicitamente configurado no arquivo Machine. config ou no arquivo Web. config raiz. No entanto, é a configuração padrão que é retornada por um aplicativo. Namespaces e controles são adicionados no arquivo Web. config raiz.

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

Informações do elemento

Manipulador da 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 Web. config do directory–level físico ou virtual
Requisitos	De da (IIS) versões 5.0 ou posteriores A.NET Framework versões 1.0 ou posteriores Visual Studio do Microsoft 2003 ou posterior

Consulte também

pages Element (ASP.NET Settings Schema)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Tarefas

Referência

Conceitos

Outros recursos

Recursos adicionais