pages Element (ASP.NET Settings Schema)
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:
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 |
|
Membro de configuração |
|
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
Tarefas
Como: Configurar Diretórios Específicos Usando Configurações por Localização
Como: Bloquear definições de configuração ASP.NET
Referência
configuração Element (Geral Configurações Schema)
Controla o elemento de páginas (ASP.NET Configurações Schema)
Elemento de namespaces para páginas (ASP.NET Configurações Schema)
tagMapping elemento para páginas (ASP.NET Configurações Schema)
system.web Element (ASP.NET Settings Schema)
Conceitos
Hierarquia e Herança do Arquivo de Configuração do ASP.NET
Protegendo a configuração do ASP.NET
Outros recursos
General Configuration Settings (ASP.NET)
ASP.NET Configuration Settings