Páginas elemento (esquema configurações ASP.NET)

Artigo
08/25/2010

Define globalmente específicas da página Configurações, sistema autônomo sistema autônomo diretivas do ASP.NET para páginas e controles que estão dentro do escopo do arquivo de configuração.

configuração elemento (Geral Settings esquema)
System.Web elemento (esquema configurações ASP.NET)
Páginas elemento (esquema configurações ASP.NET)

<pages     
   buffer="[True|False]"
   enableEventValidation="[True|False]"
   enableSessionState="[True|False|ReadOnly]"
   enableViewState="[True|False]"
   enableViewStateMac="[True|False]"
   smartNavigation="[True|False]"
   autoEventWireup="[True|False]"
   pageBaseType="typename, assembly"
   userControlBaseType="typename"
   validateRequest="[True|False]"
   masterPageFile="file path" 
   theme="string"
   styleSheetTheme="string"
   maxPageStateFieldLength="number" 
   compilationMode="[Always|Auto|Never]" 
   pageParserFilterType="string" 
   viewStateEncryptionMode="[Always|Auto|Never]" 
   maintainScrollPositionOnPostBack="[True|False]" 
   asyncTimeout="number"
>
   <controls>...</controls>
   <namespaces>...</namespaces>
   <tagMapping>...</tagMapping>
</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 a esperar por um manipulador assíncrono concluir durante o processamento assíncrono. Esse atributo é novo no .NET estrutura versão 2.0. O padrão é "0:00:45" (45 segundos).
autoEventWireup	Opcional Boolean atributo. Especifica se os eventos de página automaticamente estão habilitados. Isso é se wireup autoevent ocorrerá, que significa que o sistema irá anexar automaticamente os métodos de uma assinatura específica (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.
compilationMode	Opcional CompilationMode atributo. Especifica se uma página ASP.NET ou controle deve ser compilada em time de execução. The compilationMode atributo é novo no .NET estrutura 2.0. Esse atributo pode ser um dos seguintes valores possíveis. O padrão é Always. Valor Descrição Always A página sempre deve ser compilada. Auto ASP.NET não será compilado da página, se possível. Never A página ou controle nunca deve ser dinamicamente compilada. Se uma página contém uma construção de bloco ou código de script que requer compilação, ASP.NET retornará um erro e a página não será executado.
enableEventValidation	Especifica se as páginas e controles validam 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. The enableSessionState atributo pode ser um dos seguintes valores possíveis. O padrão é True. Valor Descrição False Indica que estado de sessão desabilitado. ReadOnly Indica que estado de sessão não é gravável. True Indica que estado de sessão é ativado.
enableViewState	Opcional Boolean atributo. Especifica se o estado de exibição é ativado e mantido entre as solicitações de página. O padrão é True.
enableViewStateMac	Opcional Boolean atributo. Especifica se o 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 do cliente. If True, o estado de exibição criptografado é verificado para verificar que não tenha sido adulterado no cliente. O padrão é True.
maintainScrollPositionOnPostBack	Opcional Boolean atributo. Especifica se deve retornar o usuário a mesma posição no navegador do cliente quando páginas são postadas no servidor. If False, o usuário será enviado de volta para a parte superior da página em um postback. Esse atributo é novo no .NET estrutura 2.0. O padrão é False.
masterPageFile	Opcional String atributo. Especifica o caminho da página mestra em relação ao arquivo de configuração local. Páginas que têm o masterPageFile atributo definido sistema autônomo True deve conter um Content controlar sistema autônomo o controle de nível superior Esse atributo é novo no .NET estrutura 2.0. The default is an empty string ("").
maxPageStateFieldLength	Opcional Int32 atributo. Especifica o comprimento máximo de caracteres para o campo de estado para a página. Se conjunto em um número positivo, o campo de estado de exibição que é enviado ao navegador do cliente é separado em partes e cada parte é menor do que o dimensionar especificado no maxPageStateFieldLength atributo. Se conjunto a um número negativo, o campo de estado de exibição não deve ser separado em blocos. Esse atributo é novo no .NET estrutura 2.0. O padrão é "-1".
pageBaseType	Opcional String atributo. Especifica a base para usar quando as páginas são autônomas somente. Isso é substituído por oinherits atributo em um arquivo autônomo. O padrão é "sistema.Web.UI.página".
pageParserFilterType	Opcional String atributo. Especifica o nome do tipo de um filtro que é usado pelo analisador ASP.NET para determinar se um item é permitido na página em time de análise. O filtro deve derivar do PageParserFilter classe. Esse atributo é novo no .NET estrutura 2.0. The default is an empty string ("").
smartNavigation	Opcional Boolean atributo. Especifica se a navegação SMART está ativada. Navegação SMART requer o Microsoft Internet Explorer versão 5.5 ou posterior. Quando a navegação SMART está habilitada, o usuário enfrenta os seguintes benefícios: Brilhante navegação é eliminado. Posição de rolar é mantida entre as páginas. Foco do elemento é mantido entre as páginas. O último estado para a página é o estado apenas mantido pelo histórico do navegador. Esse atributo é novo no .NET estrutura 2.0, mas foi substituído 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 comparação com o atributo de tema que define o tema a ser aplicado após a declaração de controle. Esse atributo é novo no .NET estrutura 2.0. The default is an empty string ("").
theme	Opcional String atributo. Especifica o nome do tema é usado para páginas que estão dentro do escopo do arquivo de configuração. O tema especificado deve existir sistema autônomo um aplicativo ou um tema global. Se o tema não existir, um HttpException exceção é lançada. Esse atributo é novo no .NET estrutura 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 somente. O padrão é "System.Web.UI.UserControl".
validateRequest	Opcional Boolean atributo. Indica que o ASP.NET examina todas as entradas do navegador para dados potencialmente perigosos. If True, validação de solicitação é executada, comparando todos os dados de entrada a uma lista de valores possivelmente perigosos. Se ocorrer uma correspondência, o ASP.NET gera um HttpRequestValidationException exceção. O padrão é True.
viewStateEncryptionMode	Opcional ViewStateEncryptionMode atributo. Especifica o modo de criptografia do estado de exibição. The ViewStateEncryptionMode propriedade substitui esse atributo, que é definido no arquivo de configuração. Esse atributo pode ser um dos seguintes valores possíveis. Valor Descrição Always Estado de exibição é sempre criptografado. Auto Estado de exibição é criptografado, se solicitar um controle. Never Estado de exibição nunca é criptografado, mesmo se um controle solicitá-la. Esse atributo é novo no .NET estrutura 2.0. O padrão é Auto.

Elementos filho

Elemento	Descrição
controls	Define um coleção de diretivas de registro e os espaços para nome 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 de marcas são remapeados para outros tipos de marcas em time de compilar.

Elementos pai

Elemento	Descrição
configuration	O elemento raiz exigido em todos os arquivos de configuração usado pelo common linguagem tempo de execução e os aplicativos .NET estrutura–based.
system.web	Especifica o elemento raiz para as definições de configuração do ASP.NET em um arquivo de configuração e contém elementos de configuração configurar aplicativos ASP.NET e o controle como os aplicativos se comportam.

Comentários

The pages elemento define específicas de página configuração Configurações. Esta seção de configuração suporta configuração determinadas diretivas de página e controle do ASP.NET 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 configurações que são usadas pelos compiladores de página e controle de usuário quando os compiladores processam a página de Web Forms do ASP.NET (.aspx) e arquivos de controle (.ascx) de usuário:

The @ Page directive (@ Page).
The @ Import directive (@ Import) through the namespaces child element.
The @ Register directive (@ Register) through the controls child element.

The pages elemento também fornece suporte para mapeamento de tipos de marcas para outros tipos de marcas em time de execução por meio do tagMapping elemento.

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

Configuração padrão

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

<pages 
   buffer="true" 
   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 de seção de configuração	PagesSection
Configuração de membro	Pages Page
Locais configuráveis	Machine.config Web.config de nível de raiz Web.config de nível de aplicativo Virtual ou física diretório–nível Web.config
Requisitos	Serviços de Informações da Internet da Microsoft (IIS) versões 5.0, 5.1 ou 6.0 As versões do .NET estrutura 1.0, 1.1 ou 2.0 Microsoft Visual Studio 2003 ou o Visual Studio 2005

Consulte também

Partilhar via

Páginas elemento (esquema configurações ASP.NET)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Tarefas

Conceitos

Referência

Outros recursos

Recursos adicionais