httpRuntime 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.]

Configura o ASP.Configurações de tempo de execução do NET HTTP que determinam como processar uma solicitação para um aplicativo ASP.NET aplicativo.

<httpRuntime
   apartmentThreading = "[True|False]"
   appRequestQueueLimit = "number"
   delayNotificationTimeout = "number"
   enable = "[True|False]" 
   enableHeaderChecking = "[True|False]" 
   enableKernelOutputCache = "[True|False]" 
   enableVersionHeader = "[True|False]" 
   encoderType = "string"
   executionTimeout = "number" 
   maxQueryStringLength = "number"
   maxRequestLength = "number" 
   maxUrlLength = "number"
   maxWaitChangeNotification = "number" 
   minFreeThreads = "number" 
   minLocalRequestFreeThreads = "number" 
   relaxedUrlToFileSystemMapping = "[True|False]"
   requestLengthDiskThreshold = "number" 
   requestPathInvalidCharacters = "string"
   requestValidationMode = "[2.0|4.0]"
   requestValidationType = "string"
   requireRootedSaveAsPath = "[True|False]"
   sendCacheControlHeader = "[True|False]" 
   shutdownTimeout = "number"
   targetFramework = "number"   useFullyQualifiedRedirectUrl = "[True|False]" 
   waitChangeNotification = "number" />

Attributes and Elements

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

Attributes

Atributo	Descrição
apartmentThreading	Opcional Boolean atributo. Permite apartment threading para compatibilidade do ASP clássica. O padrão é False.
appRequestQueueLimit	Opcional Int32 atributo. Especifica o número máximo de solicitações ASP.NET filas do aplicativo. Quando não há segmentos livres suficientes para processar uma solicitação, as solicitações são enfileiradas. Solicitações de entrada serão rejeitadas com o erro "503 - servidor muito ocupado" quando a fila excede o limite especificado nesse atributo. O padrão é 5000.
delayNotificationTimeout	Opcional Int32 atributo. Especifica o tempo limite em segundos para atrasar as notificações. O padrão é 5 segundos.
encoderType	Obtém ou define o nome de um tipo personalizado que pode ser usado como identificador HTML e codificação de URL. ASP.NET usa o HttpEncoder tipo de manipulador padrão para tarefas de codificação HTML e URL. Para personalizar o comportamento de codificação, você pode criar uma classe que herda de HttpEncoder tipo. No arquivo de configuração para um aplicativo, você definir a EncoderType atributo o httpRuntime elemento para o nome totalmente qualificado de seqüência de caracteres do tipo personalizado. Esse atributo é novo na.NET Framework versão 4.0.
enable	Opcional Boolean atributo. Especifica se o domínio do aplicativo (AppDomain) está habilitado para aceitar solicitações de entrada no nível do nó atual e o nó filho. Se False, o aplicativo é efetivamente desativado. O padrão é True.
enableHeaderChecking	Opcional Boolean atributo. Especifica se ASP.NET deve verificar se o cabeçalho de solicitação para possíveis ataques de injeção. Se um ataque for detectado, ASP.NET responde com um erro. O padrão é True.
enableKernelOutputCache	Opcional Boolean atributo. Especifica se o cache de saída está habilitado. Este atributo só é relevante quando Serviços de Informações da Internet da Microsoft (IIS) 6.0 ou posterior está instalado. A cache de configuração e tipo de solicitação de saída determina se conteúdo pode ser armazenado em cache. Armazenar em cache uma resposta, os critérios a seguir devem ser atendidos: O cache deve ser explicitamente habilitado usando a API do cache ou uma diretiva page. O cache deve ter uma diretiva de expiração para que o kernel reconhece quando descartar a resposta. Cache não tem qualquer variáveis cabeçalhos ou parâmetros. A autenticação não é necessária. O padrão é True.
enableVersionHeader	Opcional Boolean atributo. Especifica se ASP.NET deve saída um cabeçalho de versão. Esse atributo é usado pelo 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. Note Esse atributo não está disponível no.NET Framework 1.0. O padrão é True.
executionTimeout	Opcional Int32 atributo. Especifica o número máximo de segundos que uma solicitação pode ser executada antes de ser desligado automaticamente pelo ASP.NET. O tempo limite se aplica somente se a depuração de atributo de compilation é False . Portanto, se o debug é True , você não precisará definir esse atributo para um valor grande para evitar o encerramento do aplicativo enquanto você está depurando. O padrão é 110 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 negação de serviço que são causados, por exemplo, usuários que enviam arquivos grandes para o servidor. O padrão é 4096 KB. Se o limite for excedido, uma ConfigurationErrorsException exceção é lançada.
maxWaitChangeNotification	Opcional Int32 atributo. Especifica o número máximo de segundos de espera da primeira notificação de alteração de arquivo antes de reiniciar o AppDomain para uma nova solicitação. Definir esse atributo para um número é maior do que o período de tempo para concluir os processos de cópia de arquivo. Notificações de alteração de arquivo são combinadas com base no valor desse atributo e o waitChangeNotification atributo. O padrão é 0.
minFreeThreads	Opcional Int32 atributo. Especifica o número mínimo de segmentos livres para permitir a execução de novas solicitações. ASP.NET mantém o número especificado de segmentos livres para solicitações que exigem segmentos adicionais para concluir o processamento. O padrão é 8.
minLocalRequestFreeThreads	Opcional Int32 atributo. Especifica o número mínimo de segmentos livres que o ASP.NET mantém disponível para permitir a execução de novas solicitações locais. O número de threads especificado é reservado para solicitações provenientes de um host local, no caso de algumas solicitações emitirem solicitações filhas ao host local durante o processamento. Isso ajuda a evitar um possível bloqueio com entrada recursiva no servidor Web. O padrão é 4.
requestValidationMode	Opcional Int32 atributo. Obtém ou define um número de versão indica qual o ASP.NET abordagem específica de versão para validação será usada. O valor que você atribuir a essa propriedade não é validado para corresponder a uma versão específica do ASP.NET. Qualquer valor numérico menor 4.0 (por exemplo,3.7, 2.9, ou 2.0) é interpretado como 2.0. Qualquer número maior que 4.0 é interpretado como 4.0. O padrão é 4.0.
requestValidationType	Opcional String atributo. Obtém ou define o nome de um tipo que é usado para validar solicitações HTTP. Para personalizar o ASP.Comportamento de validação de solicitação NET, você pode criar uma classe que herda de RequestValidator tipo. No arquivo de configuração para um aplicativo, você definir a requestValidationType atributo o httpRuntime elemento para o nome totalmente qualificado de seqüência de caracteres do tipo personalizado O padrão é o nome totalmente qualificado do RequestValidator digite ASP.NET usa para validação
requestLengthDiskThreshold	Opcional Int32 atributo. Especifica o limite para o fluxo de entrada buffer limite, em quilobytes. Este valor não deve exceder a maxRequestLength atributo. 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 ASP.NET processo deve ter permissão para criar arquivos no local especificado. O padrão é True.
sendCacheControlHeader	Opcional Boolean atributo. Especifica se deseja enviar um cabeçalho de controle de cache, que é definido como Private, por padrão. Se True, o cache do cliente é desativado. O padrão é True.
shutdownTimeout	Opcional Int32 atributo. Especifica o número de minutos permitido para o processo do operador desligar. Quando o tempo limite expirar, ASP.NET desliga o processo de trabalho. O padrão é 90 segundos.
targetFramework	Opcional String atributo. Especifica o número de versão indica qual framework de específico da versão do Common Language Runtime (CLR) será usado. Se este atributo for omitido, a estrutura de destino é definida como 4.0. O padrão é Null.
useFullyQualifiedRedirectUrl	Opcional Boolean atributo. Especifica se os 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 relativo redireciona é enviadas ao cliente em vez disso. Se True, todos os redirecionamentos não são totalmente qualificados são convertidos automaticamente para o formulário totalmente qualificado. Note Se este atributo estiver definido como False, alguns navegadores podem encontrar problemas ao carregar páginas de sessões cookieless. O padrão é False.
waitChangeNotification	Opcional Int32 atributo. Especifica o tempo em segundos para aguardar outra notificação de alteração de arquivo antes de reiniciar o AppDomain. Definir esse atributo para um número maior que o tempo entre as atualizações da cópia do arquivo duas notificações de alteração. Notificações de alteração de arquivo são combinadas com base no valor desse atributo e o maxWaitChangeNotification atributo. O padrão é 0 segundos.
maxQueryStringLength	Opcional Int32 atributo. O comprimento máximo de seqüência de consulta, em número de caracteres. O padrão é 2048. O valor de MaxQueryStringLength propriedade pode ser qualquer inteiro zero ou maior. Se o comprimento de uma seqüência de consulta excede o limite de tamanho, o ASP.NET retorna um HTTP 400 código de status (solicitação incorreta). Note Valores extremamente pequenos podem inutilizar um site da Web. Note Também é uma configuração do IIS que controla o comprimento da seqüência de caracteres de consulta.Consulte o maxQueryString de atributo em Limites de solicitação de <requestLimits>.
maxUrlLength	Opcional Int32 atributo. O comprimento máximo da URL, em número de caracteres. O padrão é 260. O valor de MaxUrlLength propriedade pode ser qualquer inteiro zero ou maior. Se o comprimento do URL de solicitação (que é o valor da Path propriedade) excede o limite de tamanho configurado, o ASP.NET retorna um código de status HTTP 400 (solicitação incorreta) Note Valores extremamente pequenos podem inutilizar um site da Web. Também é uma configuração do IIS que controla o comprimento da seqüência de caracteres de consulta.Consulte o maxQueryString de atributo em Limites de solicitação de <requestLimits>.
relaxedUrlToFileSystemMapping	Opcional Boolean atributo. Indica se a URL em uma solicitação HTTP é necessária para ser um caminho de arquivo válido do Windows. O RelaxedUrlToFileSystemMapping propriedade determina como a URL de uma solicitação HTTP entrante será validada. Se essa propriedade for false, a URL é validada usando as mesmas regras que determinam se um caminho de sistema de arquivos do Windows é válido.
requestPathInvalidCharacters	Opcional String atributo. Uma lista separada por vírgulas de caracteres inválidos em um caminho de solicitação. A lista a seguir contém o conjunto padrão de caracteres inválidos: <,>,*,%,&,:,\

Child Elements

Nenhum.

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 do NET Framework.
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 httpRuntime elemento configura o ASP.Configurações de tempo de execução de HTTP NET determinam como uma solicitação para um aplicativo ASP.NET aplicativo é processado. O.NET Framework fornece um número de diferentes hosts de tempo de execução, incluindo o ASP.NET host de tempo de execução. Quando chegar uma solicitação no ASP.NET carrega a configuração de tempo de execução em processo 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

O httpRuntime elemento não está explicitamente definido no arquivo Machine. config ou no arquivo raiz Web. config. No entanto, as configurações a seguir são os valores padrão como inicializado pelo sistema. Se você precisar personalizar esta seção, você deve criá-lo em seu arquivo de configuração e definir os atributos que precisam de personalização.

<httpRuntime 
   apartmentThreading="false"
   appRequestQueueLimit="5000"
   delayNotificationTimeout="5"
   enable="true"
   enableHeaderChecking="true"
   enableKernelOutputCache="true"
   enableVersionHeader="true"
   encoderType = "System.Web.Util.HttpEncoder"
   executionTimeout="110"
   maxQueryStringLength = "2048"
   maxRequestLength="4096"
   maxUrlLength = "260"
   maxWaitChangeNotification="0"
   minFreeThreads="8"
   minLocalRequestFreeThreads="4"
   relaxedUrlToFileSystemMapping = "False"
   requestLengthDiskThreshold="80"
   requestPathInvalidCharacters = "<,>,*,%,&,:,\"
   requestValidationMode = "4.0"
   requestValidationType = "System.Web.Util.RequestValidator"
   requireRootedSaveAsPath="true"
   sendCacheControlHeader="true"
   shutdownTimeout="90"
   useFullyQualifiedRedirectUrl="false"
   waitChangeNotification="0" />

Exemplo

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

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

Element Information

Manipulador de seção de configuração	HttpRuntimeSection
Membro de configuração	HttpRuntime
Locais configuráveis	Machine.config Web. config de nível de raiz Web. config de nível de aplicativo Directory–level virtual ou físico Web. config
Requisitos	Serviços de Informações da Internet da Microsoft (IIS) 5.0 ou posterior

Consulte também