Partilhar via


Elemento httpRuntime (Esquema de configurações do ASP.NET)

Configura a HTTP do ASP.NET em time de execução configurações que determinem como processar uma solicitação para um aplicativo ASP.NET.

configuração elemento (Geral Settings esquema)
  System.Web elemento (esquema configurações ASP.NET) 
    Elemento httpRuntime (Esquema de configurações do ASP.NET)

<httpRuntime
      executionTimeout = "number" 
   maxRequestLength = "number" 
   requestLengthDiskThreshold = "number" 
   useFullyQualifiedRedirectUrl = "[True|False]" 
   minFreeThreads = "number" 
   minLocalRequestFreeThreads = "number" 
   appRequestQueueLimit = "number"
   enableKernelOutputCache = "[True|False]" 
   enableVersionHeader = "[True|False]" 
   apartmentThreading = "[True|False]"
   requireRootedSaveAsPath = "[True|False]"
   enable = "[True|False]" 
   sendCacheControlHeader = "[True|False]" 
      shutdownTimeout = "number"
   delayNotificationTimeout = "number"
   waitChangeNotification = "number" 
   maxWaitChangeNotification = "number" 
   enableHeaderChecking = "[True|False]" 
/>

Atributos e elementos

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

Atributos

Atributo

Descrição

apartmentThreading

Opcional Boolean atributo.

Permite a segmentação de apartment para compatibilidade do ASP clássica.

Esse atributo é novo no .NET estrutura versão 2.0. O padrão é False.

appRequestQueueLimit

Opcional Int32 atributo.

Especifica o número máximo de solicitações que ASP.NET coloca em fila para o aplicativo. Quando não há segmentos disponível suficientes para processar uma solicitação, as solicitações são na na fila. Solicitações de entrada são rejeitadas com o erro "503 - Servidor muito ocupado" quando a fila excede o limite especificado neste atributo.

O padrão é 5000.

ObservaçãoObservação:
Para obter as versões do .NET estrutura 1.0 e 1.1, o padrão é 100.

delayNotificationTimeout

Opcional TimeSpan atributo.

Especifica o time limite em segundos para atrasar as notificações.

Esse atributo é novo no .NET estrutura versão 2.0.

O padrão é 5 segundos.

Enable

Opcional Boolean atributo.

Especifica se o domínio do aplicativo (AppDomain) está ativado para aceitar solicitações de entrada no nível do nó corrente e do nó filho. If False, o aplicativo é efetivamente desativado.

O padrão é True.

enableHeaderChecking

Opcional Boolean atributo.

Especifica se o ASP.NET deve verificar o cabeçalho de solicitação de possíveis ataques de injeção. Se um ataque for detectado, o ASP.NET responde com um erro.

Esse atributo é novo no .NET estrutura 2.0.

O padrão é True.

enableKernelOutputCache

Opcional Boolean atributo.

Especifica se o cache de saída está habilitado. Este atributo só é relevante quando o Serviços de Informações da Internet da Microsoft (IIS) 6.0 ou posterior está instalado. A saída de cache de configuração e tipo de solicitação determina se conteúdo pode ser armazenado em cache.

Para uma resposta do cache, os critérios a seguir devem ser atendidos:

  • O cache deve ser explicitamente ativado, uma diretiva página ou usando a API do cache.

  • O cache deve ter uma diretiva de expiração para que o kernel reconhece quando descartar a resposta.

  • O cache não tem qualquer cabeçalhos variáveis ou parâmetro.

  • Autenticação não é necessária.

O padrão é True.

enableVersionHeader

Opcional Boolean atributo.

Especifica se deve saída no ASP.NET um cabeçalho de versão. Este atributo é usado por Microsoft Visual Studio 2005 para determinar qual versão do ASP.NET está em uso. Não é necessário para sites de produção e pode ser desabilitado.

ObservaçãoObservação:
Esse atributo não está disponível no .NET estrutura 1.0.

O padrão é True.

executionTimeout

Opcional TimeSpan atributo.

Especifica o número máximo de segundos que uma solicitação pode ser executada antes de ser desligado automaticamente pelo ASP.NET.

Esse time limite se aplicará somente se a depurar de atributo no compilation o elemento é False. Se o debug o atributo é True, para ajudar a evitar aplicativo desligado enquanto você está depurando, não conjunto esse time limite para um grande valor.

O padrão é 110 segundos.

ObservaçãoObservação:
No .NET estrutura 1.0 e 1.1, o padrão é 90 segundos.

maxRequestLength

Opcional Int32 atributo.

Especifica o limite para o fluxo de entrada buffer limite, em KB. Esse limite pode ser usado para impedir ataques de negação de serviço causados, por exemplo, por usuários postar arquivos grandes para o servidor.

O padrão é 4096 KB. Se o limite for excedido, um ConfigurationErrorsException é lançada.

maxWaitChangeNotification

Opcional Int32 atributo.

Especifica o número máximo de segundos de espera da primeira notificação de alterar de arquivo antes de reiniciar o AppDomain para uma nova solicitação. conjunto esse atributo para um número que é maior do que o comprimento de time para concluir qualquer arquivo copiar processos. As notificações de alterar de arquivo são combinadas com base no valor desse atributo e o waitChangeNotification atributo.

Esse atributo é novo no .NET estrutura 2.0.

O padrão é 0.

minFreeThreads

Opcional Int32 atributo.

Especifica o número mínimo de segmentos disponível para permitir a execução de novas solicitações. ASP.NET mantém o número de segmentos disponível para solicitações que exigem segmentos adicionais para o processamento completo especificado.

O padrão é 8.

minLocalRequestFreeThreads

Opcional Int32 atributo.

Especifica o número mínimo de segmentos livres ASP.NET mantém disponível para permitir a execução de novas solicitações locais. O número de segmentos especificado está reservado para solicitações que são originados em host local, no caso de algumas solicitações emitem solicitações filho para o host local durante o processamento. Isso ajuda a evitar um possível deadlock com entrada recursiva no servidor Web.

O padrão é 4.

requestLengthDiskThreshold

Opcional Int32 atributo.

Especifica o limite para o fluxo de entrada buffer limite, em quilobytes. Esse valor não deve exceder o maxRequestLength atributo.

Esse atributo é novo no .NET estrutura 2.0.

O padrão é 80 KB.

requireRootedSaveAsPath

Opcional Boolean atributo.

Especifica se o filename parâmetro em uma SaveAs método deve ser um caminho absoluto. O processo ASP.NET deve ter permissão para criar arquivos no local especificado.

Esse atributo é novo no .NET estrutura 2.0.

O padrão é True.

sendCacheControlHeader

Opcional Boolean atributo.

Especifica se deve enviar um cabeçalho de controle de cache, que é conjunto para Private, por padrão. If True, o cache do cliente é desabilitado.

Esse atributo é novo no .NET estrutura 2.0.

O padrão é True.

shutdownTimeout

Opcional TimeSpan atributo.

Especifica o número de minutos permitidos para o processo do operador desligar. Quando o time limite expira, o ASP.NET desliga o processo de trabalho.

Esse atributo é novo no .NET estrutura 2.0.

O padrão é 90 segundos.

useFullyQualifiedRedirectUrl

Opcional Boolean atributo.

Especifica se redirecionamentos do lado do cliente são totalmente qualificados usando o formulário "https://server/path", que é necessário para alguns controles móveis ou se redirecionamentos relativos são enviados ao cliente em vez disso. If True, todos os redirecionamentos que não são totalmente qualificados são convertidos automaticamente para o formulário totalmente qualificado.

ObservaçãoObservação:
Se este atributo estiver definido como False, alguns navegadores podem encontrar problemas ao carregar páginas que estão em sessões cookieless.

O padrão é False.

waitChangeNotification

Opcional Int32 atributo.

Especifica o time, em segundos para aguardar outra notificação de alterar de arquivo antes de reiniciar o AppDomain. conjunto esse atributo para um número maior que o time entre as atualizações de cópia de arquivos duas notificações de alterar. As notificações de alterar de arquivo são combinadas com base no valor desse atributo e o maxWaitChangeNotification atributo.

Esse atributo é novo no .NET estrutura 2.0.

O padrão é 0 segundos.

Elementos filho

Nenhum.

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 do .NET estrutura.

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 httpRuntime elemento configura as configurações de time de execução HTTP do ASP.NET que determinam como uma solicitação para um aplicativo ASP.NET é processada. O .NET estrutura fornece um número de diferentes em time de execução hosts, incluindo o ASP.NET em time de execução host. Quando uma solicitação chega, o ASP.NET carrega o em time de execução definindo no processo que é manipular a solicitação. O ASP.NET também cria um domínio de aplicativo para cada aplicativo da Web que será executado em um servidor Web.

Configuração padrão

The httpRuntime elemento não está definido explicitamente no computador. arquivo de configuração ou na Web raiz. arquivo de configuração. No entanto, sistema autônomo configurações a seguir são sistema autônomo valores padrão sistema autônomo inicializado pelo sistema. Se você precisar personalizar essa seção, você deve criá-lo em seu arquivo de configuração e define somente os atributos que precisam de personalização.

<httpRuntime 
   executionTimeout="110"
   maxRequestLength="4096"
   requestLengthDiskThreshold="80"
   useFullyQualifiedRedirectUrl="false"
   minFreeThreads="8"
   minLocalRequestFreeThreads="4"
   appRequestQueueLimit="5000"
   enableKernelOutputCache="true"
   enableVersionHeader="true"
   requireRootedSaveAsPath="true"
   enable="true"
   shutdownTimeout="90"
   delayNotificationTimeout="5"
   waitChangeNotification="0"
   maxWaitChangeNotification="0"
   requestPriority="Normal"
   enableHeaderChecking="true"
   sendCacheControlHeader="true"
   apartmentThreading="false"
/>

Exemplo

O exemplo a seguir demonstra como especificar parâmetros de time de execução HTTP para um aplicativo ASP.NET.

<configuration>
  <system.web>
  <httpRuntime maxRequestLength="4000"
    enable = "True"
    requestLengthDiskThreshold="512
    useFullyQualifiedRedirectUrl="True"
    executionTimeout="45"
    versionHeader="1.1.4128"/>
  </system.web>
</configuration>

Informações do elemento

Manipulador de seção de configuração

HttpRuntimeSection

Configuração de membro

HttpRuntime

Locais configuráveis

Machine.config

Web.config de nível de raiz

Web.config de nível de aplicativo

Virtual ou físico diretório–nível Web.config

Requisitos

Serviços de Informações da Internet da Microsoft (IIS) 5.0, 5.1 ou 6.0

O .NET estrutura 1.0, 1.1, 2.0

Microsoft Visual Studio 2003 ou o Visual Studio 2005

Consulte também

Tarefas

Como: Configurar diretórios específicos usando configurações de local

Como: Bloquear ASP.NET Configuration Settings

Conceitos

Cache de páginas ASP.NET

Hierarquia e Herança do Arquivo de Configuração do ASP.NET

Protegendo configuração ASP.NET

Cenários de configuração ASP.NET

Referência

System.Web elemento (esquema configurações ASP.NET) 

configuração elemento (Geral Settings esquema)

System.Configuration

System.Web.Configuration

HttpRuntimeSection

HttpRuntime

Outros recursos

Configurações gerais (ASP.NET)

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

Administrando ites da Web do ASP.NET

API de Configuração do ASP.NET