@ OutputCache.
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Kontroluje deklaratywny zasady aplikacji ASP buforowanie danych wyjściowych.NET strony lub kontrolki użytkownika zawartych na stronie. Aby uzyskać więcej informacji o pamięci podręcznej danych wyjściowych, zobacz ASP.NET Caching Features.
<%@ OutputCache Duration="#ofseconds"
Location="Any | Client | Downstream | Server | None |
ServerAndClient "
Shared="True | False"
VaryByControl="controlname"
VaryByCustom="browser | customstring"
VaryByHeader="headers"
VaryByParam="parametername"
VaryByContentEncoding="encodings"
CacheProfile="cache profile name | ''"
NoStore="true | false"
SqlDependency="database/table name pair | CommandNotification"
ProviderName="Provider Name"
%>
Atrybuty
Duration
Czas w sekundach, który jest buforowany formantu strony lub użytkownika. Ustawienie tego atrybutu na formant strony lub użytkownik ustanawia zasady wygasania dla odpowiedzi HTTP z obiektu i będzie automatycznie buforować wyniki kontroli strony lub użytkownika.Uwaga
Ten atrybut jest wymagany.Jeśli nie zawiera ona, wystąpi błąd parsera.
Location
Jednym z OutputCacheLocation wartości wyliczenia. Wartością domyślną jest Any.Uwaga
Ten atrybut nie jest obsługiwana dla @ OutputCache dyrektywach, zawarte w formantach użytkownika (pliki .ascx).
CacheProfile
Nazwa ustawienia pamięci podręcznej, aby skojarzyć ze stroną. Jest to atrybut opcjonalny i domyślnie jest pusty ciąg ("").Uwaga
Ten atrybut nie jest obsługiwana dla @ OutputCache dyrektywach, zawarte w formantach użytkownika (pliki .ascx).Gdy określona na stronie, wartooć musi odpowiadać nazwy dostępnych wpisy w outputCacheProfiles element pod outputCacheSettings sekcji.Jeśli nazwy nie pasują do siebie wpisu profilu, jest wyjątek.
NoStore
Wartość logiczna, która określa, czy zapobiegać magazyn pomocniczy poufnych informacji.Uwaga
Ten atrybut nie jest obsługiwana dla @ OutputCache dyrektywach, zawarte w formantach użytkownika (pliki .ascx).Ustawienie tego atrybutu true jest odpowiednikiem następujący kod wykonywany podczas żądania:
Response.Cache.SetNoStore();ProviderName
Ciąg identyfikujący niestandardowego dostawcy pamięci podręcznej danych wyjściowych do używanych. Aby uzyskać więcej informacji, zobacz uwagi części tego tematu i wpis Extensible buforowanie danych wyjściowych z ASP.NET 4 (VS 2010 i.NET serii 4.0) na blogu Scott GuthrieUwaga
Ten atrybut jest obsługiwany tylko w formantach użytkownika (pliki .ascx).To nie jest obsługiwane dla @ OutputCache dyrektyw, które są uwzględnione w ASP.NET stron (pliki .aspx).
Shared
Wartość logiczna, która określa, czy użytkownik kontroli może być współdzielona za pomocą wielu stron. Wartością domyślną jest false. Aby uzyskać więcej informacji zobacz sekcję Spostrzeżenia.Uwaga
Ten atrybut nie jest obsługiwana dla @ OutputCache dyrektywach, zawarte w programie ASP.NET stron (pliki .aspx).
SqlDependency
Wartość ciągu, który identyfikuje zestaw pary nazwa bazy danych i tabeli, które strony lub pamięci podręcznej danych wyjściowych formantu zależy. Należy zauważyć, że SqlCacheDependency klasy monitoruje tabeli w bazie danych, która zależy od pamięci podręcznej danych wyjściowych, tak aby po zaktualizowaniu elementy w tabeli te elementy są usuwane z pamięci podręcznej, gdy za pomocą opartego na tabeli sondowania. Podczas korzystania z powiadomienia (w Microsoft SQL Server 2005) z wartością CommandNotification, ostatecznie SqlDependency klasa jest używana do rejestrowania dla powiadomień kwerendy z SQL Server 2005 serwera.Uwaga
CommandNotification Wartość dla SqlDependency atrybut jest ważny tylko na stronach sieci Web (.aspx).Formanty użytkownika można używać tylko sondowania opartego na tabeli z @ OutputCache dyrektywy.
VaryByCustom
Dowolny tekst, który reprezentuje niestandardowe wyjściowe wymagania dotyczące pamięci cache. Jeśli ten atrybut jest podana wartość browser, pamięci podręcznej jest zróżnicowana przez nazwę przeglądarki i informacje o wersji głównych. Jeżeli wprowadzono ciąg niestandardowy, należy zastąpić GetVaryByCustomString metoda w pliku Global.asax aplikacji.VaryByHeader
Lista nagłówków HTTP używane w pamięci podręcznej danych wyjściowych w zależności od rozdzielonych średnikami. Gdy ten atrybut jest ustawiony na wiele nagłówków, pamięci podręcznej danych wyjściowych zawiera inną wersję żądanego dokumentu dla każdej kombinacji określonych nagłówków.Uwaga
Ustawienie VaryByHeader atrybutu włącza buforowanie elementów w buforze wszystkich wersji 1.1 HTTP, nie tylko ASP.NET pamięci podręcznej.Ten atrybut nie jest obsługiwana dla @ OutputCache dyrektyw w formantach użytkownika.
VaryByParam
Lista ciągów znaków użytych w zależności od pamięci podręcznej danych wyjściowych rozdzielonych średnikami. Domyślnie, łańcuchy te odpowiadają wartość ciągu kwerendy wysyłane z GET metoda atrybuty lub wysłane przy użyciu parametru POST metody. Gdy ten atrybut jest ustawiony na wielu parametrów, pamięci podręcznej danych wyjściowych zawiera inną wersję żądanego dokumentu dla każdej kombinacji określonych parametrów. Możliwe wartości to none, gwiazdka (*) i dowolnym prawidłowym ciągiem kwerendy lub POST Nazwa parametru.Ostrzeżenie
Albo ten atrybut lub VaryByControl atrybut jest wymagany podczas używania @ OutputCache dyrektywa w sprawie ASP.NET stron i formantów użytkownika.Błąd parsera występuje, jeśli nie zawiera ona.Jeśli nie chcesz określić parametr w zależności od zawartości pamięci podręcznej, należy ustawić wartość, none.Jeśli różnią się w pamięci podręcznej danych wyjściowych wszystkich wartości parametru ustawić atrybut gwiazdka (*).
VaryByControl
Rozdzielaną średnikami listę ciągów znaków użytych w zależności od formantu użytkownika dane wyjściowe pamięci podręcznej. Te wartości reprezentują ID wartości właściwości programu ASP.Formanty serwera netto zadeklarowane w formancie użytkownika. Aby uzyskać więcej informacji, zobacz Caching Portions of an ASP.NET Page.Uwaga
Albo ten atrybut lub VaryByParam atrybut jest wymagany podczas używania @ OutputCache dyrektywa w sprawie ASP.NET stron i formantów użytkownika.
VaryByContentEncodings
Lista ciągów, które są używane w pamięci podręcznej danych wyjściowych w zależności od rozdzielonych średnikami. VaryByContentEncodings Atrybut jest używany z Accept-Encoding nagłówka, aby ustalić sposób buforowane odpowiedzi są obsługiwane dla różnych kodowania zawartości. Aby uzyskać więcej informacji na temat sposobu określania Accept-Encoding nagłówek, zobacz sekcję 14.3 Hypertext Transfer Protocol — HTTP/1.1 specyfikacji witrynie W3C.
Uwagi
Ustawienie wartości dla pamięci podręcznej danych wyjściowych strony jest taka sama, jak manipulowanie SetExpires i SetCacheability metody poprzez Cache właściwości.
Jeśli strony formularzy sieci Web wymaga autoryzacji do przeglądania przez użytkownika, ustawia się w pamięci podręcznej danych wyjściowych Cache-Control nagłówek HTTP do private. Aby uzyskać więcej informacji dotyczących tych przedmiotów, zobacz Caching ASP.NET Pages.
Jeśli ustawisz Shared atrybutu do true, buforowane wyjściowe formantu użytkownika są dostępne dla wielu stronach formularzy sieci Web. Jeśli nie ustawione, true, zachowanie domyślne jest do pamięci podręcznej jednej wersji danych wyjściowych formantu użytkownika dla każdej strony zawierającej ten formant użytkownika. Potencjalnie można zapisać znaczną ilość pamięci, umożliwiając Shared atrybut. Aby uzyskać więcej informacji, zobacz Caching Portions of an ASP.NET Page.
Przykład
Poniższy przykład kodu pokazuje, w jaki sposób można ustawić czas trwania, dla którego formant strony lub użytkownika jest buforowane dane wyjściowe.
<%@ OutputCache Duration="100" VaryByParam="none" %>
Następny przykład kodu pokazuje, jak Poinstruuj dane wyjściowe pamięci podręcznej do buforu formantu strony lub użytkownika przez jego lokalizacja i zliczanie parametry formularza z poziomu formularza POST metody lub ciąg kwerendy. Każde żądanie HTTP, przychodzący do innej lokalizacji lub parametr liczba (lub oba) są buforowane na dziesięć sekund. Kolejne żądania w tej samej wartości parametrów są spełnione z pamięci podręcznej do momentu wygaśnięcia wejścia.
<%@ OutputCache Duration="10" VaryByParam="location;count" %>
Zobacz też
Informacje
Tekst szablonu dyrektywy składni