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. .gif "Observação") 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 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 |
|
Configuração de membro |
|
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
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)
Outros recursos
Configurações gerais (ASP.NET)
Definições de configuração ASP.NET