Podelement outputCache elementu caching (schéma nastavení ASP.NET)
Určuje nastavení výstupní mezipaměti celé aplikace.
<outputCache enableOutputCache="true|false"
enableFragmentCache="true|false"
sendCacheControlHeader="true|false"
omitVaryStar="true|false"
defaultProvider="AspNetInternalProvider">
</outputCache>
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 |
|---|---|
enableOutputCache |
Volitelný Boolean atributu. Povolí nebo zakáže výstupní mezipaměť stránky. Je-li neaktivní, nejsou žádné stránky ukládány do mezipaměti bez ohledu na programové nebo deklarativní nastavení. Výchozí hodnota je true. |
enableFragmentCache |
Nepovinný atribut Boolean. Povolí nebo zakáže mezipaměť fragmentu aplikace. Je-li neaktivní, nejsou žádné stránky uloženy v mezipaměti bez ohledu na to, zda je použita direktiva @ OutputCache nebo profil vyrovnávací paměti. Zahrnuje hlavičku řízení mezipaměti označující, že proxy servery ve směru klient-server, stejně jako klienti prohlížeče, by neměli pokoušet ukládat výstup stránky do mezipaměti. Výchozí hodnota je false. |
sendCacheControlHeader |
Nepovinný atribut Boolean. Získá nebo nastaví hodnotu označující, zda je ve výchozím nastavení odeslána hlavička cache-control:private modulem výstupní mezipaměti. Výchozí hodnota je false. |
omitVaryStar |
Nepovinný atribut Boolean. Povolí nebo zakáže odesílání hlavičky protokolu HTTP "Vary: *" v odpovědi. S výchozím nastavením hodnoty false, je hlavička "Vary: *" odeslána pro stránky s výstupní mezipamětí. Výchozí hodnota je false. |
defaultProvider |
Volitelný atribut typu string. Získá nebo nastaví výchozího poskytovatele výstupní mezipaměti. Výchozí hodnota je "AspNetInternalProvider". Toto je mezipaměť v paměti poskytovaná technologií ASP.NET. |
Podřízené prvky
Prvek |
Popis |
|---|---|
providers |
Volitelný podřízený element, který lze použít ke konfiguraci vlastních poskytovatelů výstupní mezipaměti. |
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 pro nastavení konfigurace technologie ASP.NET v konfiguračním souboru. Obsahuje konfigurační prvky, které konfigurují webové aplikace technologie ASP.NET a ovládají chování aplikací. |
caching |
Konfiguruje nastavení mezipaměti webové aplikace. |
Poznámky
Výchozí konfigurace
Následující výchozí outputCache element není explicitně konfigurována v konfiguračním souboru počítače nebo kořenový soubor Web.config, ale je vrácena výchozí konfigurace aplikace v.NET Framework verze 2.0.
<outputCache enableOutputCache = "true"
enableFragmentCache = "true"
sendCacheControlHeader = "true"
omitVaryStar = "false"
defaultProvider="AspNetInternalProvider">
</outputCache>
Následující příklad ukazuje, jak zakázat výstupní mezipaměti pro ASP.NET aplikací:
<outputCache enableOutputCache="false" />
Rozšiřitelné ukládání výstupu do mezipaměti
PROSTŘEDÍ ASP.NET umožňuje rozšířit ukládání výstupu do mezipaměti a jednoho nebo více zprostředkovatelů výstupní mezipaměti vlastní konfigurace. Poskytovatelé výstupní mezipaměti mohou použít jakýkoli mechanismus ukládání pro perzistentní obsah HTML. Tyto možnosti ukládání mohou zahrnovat místní nebo vzdálené disky, distribuované úložiště a distribuované mezipaměti.
Rozšiřující zprostředkovatel výstupní mezipaměti umožňuje dokonalejší návrhu a inteligentnější strategie ukládání výstupu do mezipaměti pro webové servery. Můžete například vytvořit poskytovatele výstupní mezipaměti, který ukládá do mezipaměti "Nejlepších 10" stránek webu v paměti, při ukládání stránek do mezipaměti tak získáte nižší provoz na disku. Alternativně můžete ukládat do mezipaměti všechny kombinace vykreslované stránky, ale použitím distribuované mezipaměť tak, že spotřeba paměti je převeda z front-end webových serverů.
Vytvořit vlastní výstupní mezipaměť poskytovatele jako třídy, který je odvozen od OutputCacheProvider typu. V souboru Web.config můžete nakonfigurovat zprostředkovatele pak pomocí providers Subsekce z outputCache prvku.
Výchozí prostředí ASP.NET všechny odpovědi HTTP vykreslené stránky a pomocí ovládacích prvků v paměti výstupní mezipaměť v předchozím příkladu (kde defaultProvider atribut nastaven na AspNetInternalProvider). Můžete změnit výchozího poskytovatele výstupní mezipaměti použitého pro webovou aplikaci zadáním názvu jiného poskytovatele do defaultProvider.
Kromě toho můžete vybrat různé poskytovatele výstupní mezipaměti pro jednotlivé ovládací prvky a pro jednotlivé požadavky. Určit různé zprostředkovatele výstupní mezipaměti pro různé ovládací prvky webového uživatele nejsnáze tak deklarativně provést pomocí providerName atributu směrnice stránku nebo ovládacího prvku, jak ukazuje následující příklad:
<%@ OutputCache Duration="60" VaryByParam="None"
providerName="DiskCache" %>
Zadat zprostředkovatele jiné výstupní mezipaměti pro požadavek HTTP a přepsat GetOutputCacheProviderName metody v souboru Global.asax programově určit kterého poskytovatele pro konkrétní požadavek.
Viz také
Úkoly
Návod: Použití ukládání výstupu do mezipaměti pro vylepšení výkonu webu
Postupy: Uzamknutí nastavení konfigurace technologie ASP.NET
Odkaz
Koncepty
Přehled mezipaměti technologie ASP.NET
Zabezpečení konfigurace technologie ASP.NET
Scénáře konfigurace technologie ASP.NET