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

Artigo
08/25/2010

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çã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çã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çã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çã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

Partilhar via

Elemento httpRuntime (Esquema de configurações do 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