outputCache Element buforowania (ASP.Schemat ustawień netto)
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Określa ustawienia pamięci podręcznej danych wyjściowych aplikacji WWW.
<outputCache enableOutputCache="true|false"
enableFragmentCache="true|false"
sendCacheControlHeader="true|false"
omitVaryStar="true|false"
defaultProvider="AspNetInternalProvider">
</outputCache>
Atrybuty i elementy
W poniższych sekcjach opisano atrybuty i elementy podrzędne elementy nadrzędne.
Atrybuty
Atrybut |
Opis |
|---|---|
enableOutputCache |
Opcjonalny Boolean atrybut. Włącza/wyłącza pamięci podręcznej danych wyjściowych strony. Jeśli wyłączona, strony nie są buforowane niezależnie od ustawienia programowe lub deklaracyjne. Wartością domyślną jest true. |
enableFragmentCache |
Opcjonalny Boolean atrybut. Włącza/wyłącza pamięć podręczną fragmentu aplikacji. Jeśli wyłączona, strony nie są buforowane bez względu na to @ OutputCache dyrektywa lub profil używany buforowania. Zawiera nagłówek z cache-control wskazujące, że serwery proxy kopalnianych, jak również przeglądarek klientów nie należy próbować wyniki strony w pamięci podręcznej. Wartością domyślną jest false. |
sendCacheControlHeader |
Opcjonalny Boolean atrybut. Pobiera lub ustawia wartość wskazującą, czy cache-control:private nagłówka jest wysyłane przez moduł pamięci podręcznej danych wyjściowych domyślnie. Wartością domyślną jest false. |
omitVaryStar |
Opcjonalny Boolean atrybut. Włącza/wyłącza wysyłanie HTTP "Vary: *" Nagłówek w odpowiedzi. Z domyślnym ustawieniem false, "Vary: *" Nagłówek jest przesyłanych dla stron pamięci podręcznej danych wyjściowych. Wartością domyślną jest false. |
defaultProvider |
Atrybut opcjonalny ciąg znaków. Zwraca lub ustawia domyślny dostawca pamięci podręcznej danych wyjściowych. Wartością domyślną jest "AspNetInternalProvider". Jest to pamięci podręcznej w pamięci, świadczone przez ASP.NET. |
Elementy podrzędne
Element |
Opis |
|---|---|
providers |
Element podrzędny opcjonalne, używany do konfigurowania niestandardowych dostawców pamięci podręcznej danych wyjściowych. |
Elementy nadrzędne
Element |
Opis |
|---|---|
configuration |
Element główny wymagane w każdym pliku konfiguracyjnym używane przez aparatu plików wykonywalnych języka wspólnego i.NET Framework aplikacji. |
system.web |
Określa element główny dla aplikacji ASP.Ustawienia konfiguracji netto w pliku konfiguracyjnym. Zawiera elementy konfiguracyjne określające konfigurację programu ASP.NET aplikacje sieci Web i kontrolować zachowanie tych aplikacji. |
caching |
Konfiguruje ustawienia pamięci podręcznej dla aplikacji sieci Web. |
Uwagi
Domyślna konfiguracja
Następujące domyślne outputCache element nie jest jawnie skonfigurowane w pliku konfiguracyjnym komputera lub w pliku Web.config w katalogu głównego, ale jest domyślna konfiguracja zwracane przez aplikację w.NET Framework w wersji 2.0.
<outputCache enableOutputCache = "true"
enableFragmentCache = "true"
sendCacheControlHeader = "true"
omitVaryStar = "false"
defaultProvider="AspNetInternalProvider">
</outputCache>
Poniższy przykład pokazuje, jak wyłączenie pamięci podręcznej danych wyjściowych dla aplikacji ASP.NET aplikacji:
<outputCache enableOutputCache="false" />
Extensible buforowanie danych wyjściowych
ASP.NET pozwala rozszerzyć buforowanie danych wyjściowych i skonfigurować jeden lub więcej niestandardowych dostawców pamięci podręcznej danych wyjściowych. Dostawców pamięci podręcznej danych wyjściowych można użyć dowolnego mechanizm przechowywania do utrwalania zawartości HTML. Te opcje magazynowania można obejmują dysków lokalnych lub zdalnych, składowania, chmury i rozproszonych silników pamięci podręcznej.
Dostawca pamięci podręcznej danych wyjściowych rozszerzalności umożliwia bardziej agresywny projektu i bardziej inteligentna strategii buforowanie danych wyjściowych dla witryn sieci Web. Na przykład można utworzyć dostawcę pamięci podręcznej danych wyjściowych, który buforuje strony "10 pierwszych" lokacji w pamięci, podczas gdy buforowanie stron, które pobierają niższe ruchu na dysku. Alternatywnie można pamięci podręcznej każdej kombinacji różnią się przez strony wytopione, ale użyj rozproszonej pamięci podręcznej, dzięki czemu zużycie pamięci jest Odciążone z serwerów frontonu sieci Web.
Tworzenie niestandardowego dostawcy pamięci podręcznej danych wyjściowych jako klasa, która wynika z OutputCacheProvider typu. Można następnie skonfigurować dostawcę w pliku Web.config, za pomocą providers podsekcja z outputCache element.
Domyślnie w programie ASP.NET, wszystkie odpowiedzi HTTP, renderowania stron i formantów pamięci podręcznej danych wyjściowych w pamięci, które w poprzednim przykładzie jest używany (gdzie defaultProvider atrybut jest ustawiony na AspNetInternalProvider). Można zmienić domyślnego dostawcę pamięci podręcznej danych wyjściowych, używane w aplikacji sieci Web, określając nazwę innego dostawcę dla defaultProvider.
Dodatkowo możesz wybrać różnych dostawców pamięci podręcznej danych wyjściowych dla poszczególnych kontroli i indywidualne żądania. Najprostszym sposobem określania innego dostawcę pamięci podręcznej danych wyjściowych dla różnych formantów użytkownika sieci Web jest tak deklaratywny zrobić za pomocą providerName atrybutu w dyrektywie strony lub kontroli, jak pokazano w następującym przykładzie:
<%@ OutputCache Duration="60" VaryByParam="None"
providerName="DiskCache" %>
Można określić dostawcę pamięci podręcznej danych wyjściowych innego dla żądania HTTP i zastąpić GetOutputCacheProviderName metoda w pliku Global.asax programowo określić dostawcę na specjalne żądanie.
Zobacz też
Zadania
Walkthrough: Using Output Caching to Enhance Web Site Performance
How to: Lock ASP.NET Configuration Settings
Informacje
Koncepcje
Securing ASP.NET Configuration
ASP.NET Configuration Scenarios