element httpRuntime (schéma nastavení technologie ASP.NET)

Článek
08/11/2011

Konfiguruje nastavení za běhu protokolu HTTP technologie ASP.NET, které určuje, jak zpracovat požadavek pro aplikace 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]" 
/>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Atribut	Popis
apartmentThreading	Volitelný Boolean atributu. Umožňuje podprocesový model apartment pro klasickou ASP kompatibilitu. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je False.
appRequestQueueLimit	Nepovinný atribut Int32. Určuje maximální počet požadavků, které technologie ASP.NET zařadí do fronty pro aplikace. Když nebude dostatek volných vláken ke zpracování žádosti, budou žádosti uloženy ve frontě požadavků. Příchozí požadavky budou odmítnuty s chybou „ 503 – Server je zaneprázdněn ", jestliže fronta překročí limit zadaný v tomto atributu. Výchozí hodnota je 5000. Poznámka Pro rozhraní .NET Framework verze 1.0 a 1.1 je výchozí hodnota 100.
delayNotificationTimeout	Nepovinný atribut Int32. Určuje časový limit v sekundách pro zpoždění oznámení. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je 5 sekund.
encoderType	Získá nebo nastaví název vlastní typ, který lze použít na úchyt HTML a kódování adres URL. PROSTŘEDÍ ASP.NET používá HttpEncoder typu jako výchozí pro zpracování HTML a URL kódování úkoly. Chcete-li upravit chování kódování můžete vytvořit třídu, která dědí z HttpEncoder typu. V konfiguračním souboru aplikace potom nastavíte EncoderType atributu httpRuntime prvek úplný řetězec názvu typu vlastní. Tento atribut je v novém.NET Framework verze 4.
Enable	Volitelný Boolean atributu. Určuje, zda je povolena doména aplikace (AppDomain), aby mohly být přijímány příchozí požadavky na úrovni aktuálního uzlu a podřízeného uzlu. Jestliže False, tak je aplikace účinně vypnuta. Výchozí hodnota je True.
enableHeaderChecking	Nepovinný atribut Boolean. Určuje, zda by měla technologie ASP.NET kontrolovat hlavičku žádosti kvůli možným útokům pomocí vkládáním příkazu. Pokud je zjištěno napadení, technologie ASP.NET vrátí chybu. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je True.
enableKernelOutputCache	Nepovinný atribut Boolean. Určuje, zda je povoleno ukládání výstupu do mezipaměti. Tento atribut je relevantní, jestliže je nainstalována Microsoft Internetová informační služba (IIS) 6.0 nebo novější. Konfigurace ukládání výstupu do mezipaměti a typ žádosti určují, zda lze obsah uložit do mezipaměti. Chcete-li odpověď zapsat do mezipaměti, musí být splněny následující kritéria: Ukládání do mezipaměti musí být výslovně povoleno direktivou stránky nebo pomocí rozhraní API pro mezipaměť. Ukládání do mezipaměti musí mít zásadu vypršení platnosti, aby jádro rozpoznalo, kdy chcete zahodit odpovědi. Ukládání do mezipaměti nemá žádné proměnné hlavičky nebo parametry. Ověření není požadováno. Výchozí hodnota je True.
enableVersionHeader	Volitelný Boolean atributu. Určuje, zda by měla technologie ASP.NET propagovat hlavičku verze. Tento atribut je používán Microsoft Visual Studio 2005 k určení, která verze technologie ASP.NET se používá. Není to nezbytné pro provozní weby a může to být zakázáno. Poznámka Tento atribut není k dispozici v rozhraní .NET Framework 1.0. Výchozí hodnota je True.
executionTimeout	Nepovinný atribut Int32. Určuje maximální počet sekund, po které je povoleno provést žádost, než je automaticky vypnuta technologií ASP.NET. Tento časový limit lze použít pouze v případě, že atribut debug v elementu compilation je False. Pokud atribut debug je True, chcete-li pomoci zabránit vypnutí při ladění aplikace, nenastavujte tento časový limit na velké hodnoty. Výchozí hodnota je 110 sekund. Poznámka V rozhraní .NET Framework 1.0 a 1.1 je výchozí hodnota 90 sekund.
maxRequestLength	Nepovinný atribut Int32. Určuje limit pro mezní hodnotu vstupního datového proudu při ukládání do vyrovnávací paměti v KB. Tento limit lze použít k předejití útoku s cílem způsobit odepření služby, které jsou způsobeny například uživateli, kteří posílají na server velké soubory. Výchozí hodnota je 4096 KB. Pokud je překročen práh, ConfigurationErrorsException je výjimka.
maxWaitChangeNotification	Volitelný Int32 atributu. Určuje maximální počet sekund na čekání od prvního oznámení o změně souboru, před restartováním domény aplikace, kvůli nové žádosti. Nastavte tento atribut na hodnotu větší než doba k provedení jakéhokoliv procesu kopírování souborů. Oznámení o změnách souborů se kombinují podle hodnoty tohoto atributu a atributu waitChangeNotification. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je 0.
minFreeThreads	Nepovinný atribut Int32. Určuje minimální počet volných podprocesů, které umožní provádění nových požadavků. Technologie ASP.NET udržuje zadaný počet volných podprocesů pro požadavky, které vyžadují další podprocesy pro dokončení zpracování. Výchozí hodnota je 8.
minLocalRequestFreeThreads	Nepovinný atribut Int32. Určuje minimální počet volných podprocesů, které technologie ASP.NET udržuje k dispozici pro spuštění nových místních požadavků. Určuje počet podprocesů, které jsou vyhrazeny pro požadavky pocházející od místního hostitele v případě, že některé požadavky při zpracování vydají podřízené požadavky na místního hostitele. To pomáhá zabránit možnému zablokování rekurzivními návraty do webového serveru. Výchozí hodnota je 4.
requestValidationMode	Volitelný Int32 atributu. Získá nebo nastaví ASP, které označuje číslo verze.NET verze zvláštní přístup k ověření bude použito. Hodnoty přiřazené k této vlastnosti nejsou ověřena odpovídající zvláštní verzi ASP.NET. Libovolnou číselnou hodnotu menší než 4.0 (například 3.7, 2.9, nebo 2.0) je interpretován jako 2.0. Libovolné číslo větší než 4.0 interpretována jako 4.0 Výchozí hodnota je 4.0.
requestValidationType	Volitelný String atributu. Získá nebo nastaví název typu, který se používá k ověření požadavků HTTP. Přizpůsobení prostředí ASP.NETTO požadavku ověření chování můžete vytvořit třídu, která dědí z RequestValidator typu. V konfiguračním souboru aplikace potom nastavíte requestValidationType atributu httpRuntime prvek řetězce plně kvalifikovaný název vlastní typ Výchozí hodnota je plně kvalifikovaný název RequestValidator Zadejte prostředí ASP.NET používá pro ověření
requestLengthDiskThreshold	Volitelný Int32 atributu. Určuje limit pro mezní hodnotu vstupního datového proudu při ukládání do vyrovnávací paměti, v kilobajtech. Tato hodnota by neměla překročit atribut maxRequestLength. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je 80 KB.
requireRootedSaveAsPath	Nepovinný atribut Boolean. Určuje, zda parametr filename v metodě SaveAs musí být absolutní cesta. Proces technologie ASP.NET musí mít oprávnění k vytváření souborů v určeném umístění. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je True.
sendCacheControlHeader	Nepovinný atribut Boolean. Určuje, zda má být odeslána hlavička mezipaměti, která je ve výchozím nastavení nastavena na Private. Jestliže True, mezipaměť na straně klienta je neaktivní. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je True.
shutdownTimeout	Nepovinný atribut Int32. Určuje počet minut, které jsou povoleny pro pracovní proces na ukončení. Po vypršení časového limitu, technologie ASP.NET vypne pracovní proces. Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je 90 sekund.
useFullyQualifiedRedirectUrl	Nepovinný atribut Boolean. Určuje, zda přesměrování na straně klienta jsou plně kvalifikované pro použití ve tvaru "https://server/path", který je vyžadován pro některé ovládací prvky pro mobilní aplikace, nebo zdali jsou namísto toho klientovi odesílána relativní přesměrování. Jestliže True, všechny přesměrování, které nejsou plně kvalifikované jsou automaticky převedeny na plně kvalifikovaný formát. Poznámka Pokud je tento atribut nastaven na False, na některých prohlížečích může dojít k potížím při načítání stránky, které jsou v relaci bez souborů cookie. Výchozí hodnota je False.
waitChangeNotification	Nepovinný atribut Int32. Určuje dobu v sekundách čekání na jiné oznámení o změně souboru před restartováním domény aplikace. Nastavte tento atribut na číslo, které je větší než čas mezi aktualizacemi dvou oznámení o změně kopie souborů. Oznámení o změnách souborů se kombinují podle hodnoty tohoto atributu a atributu maxWaitChangeNotification . Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je 0 sekund.

Podřízené prvky

Žádný

Nadřazené prvky

Prvek	Popis
configuration	Požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
system.web	Určuje kořenový element konfiguračního souboru s nastavením konfigurace technologie ASP.NET a obsahuje konfigurační prvky, které konfigurují webové aplikace ASP.NET a řídí chování aplikací.

Poznámky

Element httpRuntime konfiguruje nastavení za běhu HTTP technologie ASP.NET, které určuje způsob, jak je zpracována žádost pro aplikace ASP.NET. Rozhraní .NET Framework poskytuje několik různých hostitelů za běhu, včetně hostitele za běhu technologie ASP.NET. Pokud přijde žádost, technologie ASP.NET načte nastavení za běhu do procesu, který má zpracovat žádost. Technologie ASP.NET také vytváří domény aplikace pro každou webovou aplikaci, která bude spuštěna na webovém serveru.

Výchozí konfigurace

Element httpRuntime není explicitně definován v souboru Machine.config nebo v kořenu souboru web.config. Následující nastavení jsou však výchozí hodnoty inicializovány systémem. Potřebujete-li přizpůsobit tento oddíl, musíte jej vytvořit ve Vašem konfiguračním souboru a definovat pouze ty atributy, které je třeba přizpůsobit.

<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"
/>

Příklad

Následující příklad ukazuje, jak určit parametry za běhu protokolu HTTP pro aplikace technologie ASP.NET.

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

Informace prvku

Obslužná rutina konfiguračního oddílu	HttpRuntimeSection
Konfigurační člen	HttpRuntime
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně Soubor web.config na úrovni fyzického nebo virtuálního adresáře
Požadavky	Microsoft Internet Information Services (IIS) 5.0, 5.1 nebo 6.0 .NET Framework 1.0, 1.1, 2.0 Microsoft Visual Studio 2003 nebo Visual Studio 2005

Viz také

Share via