httpRuntime Element (ASP.NET Settings Schema)

Artigo
08/04/2011

Configura o ASP.Configurações de tempo de execução do NET HTTP que determinam como processar uma solicitação para uma página ASP.NET Visual Basic.

<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 que o modelo apartment threading para compatibilidade do ASP clássica. Esse atributo é novo na.NET Framework versão 2.0. O padrão é False.
appRequestQueueLimit	Opcional Int32 atributo. Especifica o número máximo de solicitações que o ASP.NET filas para o aplicativo. Quando não há segmentos livres suficientes para processar uma solicitação, as solicitações são enfileiradas. Solicitações de entrada são rejeitadas com o erro "503 - Servidor muito ocupado" Quando a fila excede o limite especificado nesse atributo. O padrão é 5000. Observação Para o.NET Framework versões 1.0 e 1.1, o padrão é 100.
delayNotificationTimeout	Opcional Int32 atributo. Especifica o tempo limite em segundos para atrasar a notificações. Esse atributo é novo na.NET Framework versão 2.0. O padrão é 5 segundos.
encoderType	Obtém ou define o nome de um tipo personalizado que pode ser usado para a alça de HTML e codificação de URL. ASP.NET usa o HttpEncoder o tipo como o manipulador padrão de HTML e URL de codificação de tarefas. 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.
Enable	Opcional Boolean atributo. Especifica se o domínio de 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 desativadas. O padrão é True.
enableHeaderChecking	Opcional Boolean atributo. Especifica se ASP.NET deve verificar o cabeçalho de solicitação para possíveis ataques de injeção. Se um ataque for detectado, ASP.NET responde com um erro. Esse atributo é novo na.NET Framework 2.0. 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 o tipo de solicitação de saída determina se conteúdo pode ser armazenada em cache. Para uma resposta em cache, os critérios a seguir devem ser atendidos: O cache deve ser habilitado explicitamente usando a API de cache ou uma diretiva page. O cache deve ter uma diretiva de expiração que o kernel reconheça quando descartar a resposta. O cache não tem qualquer variáveis cabeçalhos ou os parâmetros. Autenticação não é necessária. O padrão é True.
enableVersionHeader	Opcional Boolean atributo. Especifica se ASP.NET deve dar saída a um cabeçalho de versão. Esse 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ção Esse atributo não está disponível na.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. Esse tempo limite se aplica somente se a depuração de atributo de compilation o elemento é False. Se o debug atributo é True, para ajudar a evitar aplicativo desligado enquanto você está depurando, não configure este tempo limite para um grande valor. O padrão é 110 segundos. Observação No.NET Framework 1.0 e 1.1, o padrão é 90 segundos.
maxRequestLength	Opcional Int32 atributo. Especifica o limite para o fluxo de entrada que o buffer de limite, em KB. Esse limite pode ser usado para impedir ataques dos causados, por exemplo, por 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. As notificações de alteração de arquivo são combinadas com base no valor desse atributo e o waitChangeNotification atributo. Esse atributo é novo na.NET Framework 2.0. 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 precisam de 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 segmentos especificado está 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 que indica qual o ASP.NET abordagem de versão específica para a validação será usada. O valor que você atribuir a essa propriedade não é validado para coincidir com uma versão específica do ASP.NET. Qualquer valor numérico menor do que 4.0 (por exemplo, 3.7, 2.9, ou 2.0) é interpretado como 2.0. Qualquer número maior do 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 de rede, 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 da RequestValidator Digite que o ASP.NET usa para validação
requestLengthDiskThreshold	Opcional Int32 atributo. Especifica o limite para o fluxo de entrada que o buffer de limite, em quilobytes. Esse valor não deve exceder a maxRequestLength atributo. Esse atributo é novo na.NET Framework 2.0. O padrão é 80 KB.
requireRootedSaveAsPath	Opcional Boolean atributo. Especifica se a filename parâmetro em um SaveAs o método deve ser um caminho absoluto O ASP.NET processo deve ter permissão para criar arquivos no local especificado. Esse atributo é novo na.NET Framework 2.0. 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 está desabilitada. Esse atributo é novo na.NET Framework 2.0. O padrão é True.
shutdownTimeout	Opcional Int32 atributo. Especifica o número de minutos permitidos para o processo do operador desligar. Quando o tempo limite expira, o ASP.NET desliga o processo do operador. Esse atributo é novo na.NET Framework 2.0. O padrão é 90 segundos.
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 os redirecionamentos relativos são enviados ao cliente em vez disso. Se True, que são não totalmente qualificados de todos os redirecionamentos são convertidos automaticamente para o formulário totalmente qualificado. Observação Se esse atributo estiver definido como False, alguns navegadores podem encontrar problemas ao carregar as páginas que estão em sessões sem cookies. 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 de cópia de arquivo duas notificações de alteração. As notificações de alteração de arquivo são combinadas com base no valor desse atributo e o maxWaitChangeNotification atributo. Esse atributo é novo na.NET Framework 2.0. O padrão é 0 segundos.

Elementos filho

Nenhum.

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 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 para configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.

Comentários

O httpRuntime elemento configura o ASP.Configurações de tempo de execução do NET HTTP que determinam como uma solicitação para uma página ASP.NET aplicativo é processado. A.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 uma solicitação chega, ASP.NET carrega a configuração de tempo de execução 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

O httpRuntime é o elemento não explicitamente definido no arquivo Machine. config ou no arquivo Web. config raiz. No entanto, as configurações a seguir são os valores padrão, como inicializado pelo sistema. Se você precisar personalizar esta seção deve criá-lo no seu arquivo de configuração e definir 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 tempo de execução HTTP para um aplicativo ASP.NET Visual Basic.

<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 da 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 Virtual ou física directory–level Web. config
Requisitos	De Serviços de Informações da Internet da Microsoft (IIS) 5.0, 5.1 ou 6.0 A.NET Framework 1.0, 1.1, 2.0 Microsoft Visual Studio 2003 ou 2005 de Visual Studio

Consulte também