Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Yayımlayanlar Rick Anderson ve Kirk Larkin
Yanıt önbelleğe alma, bir istemcinin veya ara sunucunun web sunucusuna yaptığı istek sayısını azaltır. Yanıt önbelleğe alma, web sunucusunun yanıt oluşturmak için gerçekleştirdiği çalışma miktarını da azaltır. Yanıt önbelleğe alma üst bilgilerde ayarlanır.
ResponseCache özniteliği yanıt önbelleğe alma üst bilgilerini ayarlar. İstemciler ve ara ara proxy'ler RFC 9111: HTTP Önbelleğe Alma belirtimi altındaki yanıtları önbelleğe alma için üst bilgileri dikkate almalıdır.
HTTP 1.1 Önbelleğe alma belirtimini izleyen sunucu tarafı önbelleğe alma için yanıt önbelleğe alma ara yazılımını kullanın. Ara yazılım, ResponseCacheAttribute özelliklerini sunucu tarafı önbelleğe alma davranışını etkilemek için kullanabilir.
Yanıt önbelleğe alma ara yazılımı , HTTP Cache-Control üst bilgilerine göre sunucu yanıtlarının önbelleğe alınmasını sağlar.
Önbelleğe alma davranışı standart HTTP önbelleğe alma semantiği uygular.
Önbelleğe alma, ara sunucular tarafından kullanılan yönteme benzer HTTP önbellek üst bilgilerini temel alır.
Bu önbelleğe alma biçimi, önbelleğe alma koşullarının karşılandığı istemcilerden gelen genel GET veya HEAD API istekleri için kullanışlıdır.
Pages gibi Razor kullanıcı arabirimi uygulamaları için yanıt önbelleğe alma genellikle yararlı olmaz. Tarayıcılar genellikle önbelleğe almayı engelleyen istek üst bilgilerini ayarlar.
Output önbelleğe alma (.NET 7 ve sonraki sürümlerde kullanılabilir) kullanıcı arabirimi uygulamaları için daha iyi bir yaklaşımdır. Bu senaryoda yapılandırma, HTTP üst bilgilerinden bağımsız olarak nelerin önbelleğe alındığını belirler.
Yanıt önbelleğe almayı test etmek için Fiddler'ı veya istek üst bilgilerini açıkça ayarlayabilen başka bir aracı kullanın. Üst bilgileri açıkça ayarlamak, önbelleğe alma testi için tercih edilir. Daha fazla bilgi için bkz Yanıt önbelleğe alma katmanı sorunlarını giderme>.
Örnek kodu görüntüleme veya indirme (indirme)
HTTP tabanlı yanıt önbelleğe alma
RFC 9111: HTTP Önbelleğe Alma belirtimi, internet önbelleklerinin nasıl davranması gerektiğini açıklar. Önbelleğe alma için kullanılan birincil HTTP üst bilgisi, önbellek yönergelerini belirtmek için kullanılan Önbellek Denetimi'dir. İstekler istemcilerden sunuculara ve yanıtlar sunuculardan istemcilere geri dönerken yönergeler önbelleğe alma davranışını denetler. İstekler ve yanıtlar ara sunucularda taşınır ve proxy sunucuları da HTTP 1.1 Önbelleğe alma belirtimine uygun olmalıdır.
Ortak Cache-Control yönergeler aşağıdaki tabloda gösterilmiştir.
| Directive | Action |
|---|---|
| public | Önbellek yanıtı depolayabilir. |
| private | Paylaşılan önbellek yanıtı depolamamalıdır. Özel önbellek yanıtı depolayabilir ve yeniden kullanabilir. |
| max-age | İstemci, yaşı belirtilen saniye sayısından büyük olan bir yanıtı kabul etmez. Örnekler: max-age=60 (60 saniye), max-age=2592000 (bir ay) |
| no-cache |
İsteklerde: Önbellek, isteği karşılamak için depolanmış yanıt kullanmamalıdır. Kaynak sunucu istemci için yanıtı yeniden oluşturur ve ara yazılım, depolanan yanıtı önbelleğinde güncelleştirir. Yanıtlarda: Yanıt, kaynak sunucuda doğrulama yapılmadan sonraki bir istek için kullanılmamalıdır. |
| no-store |
İsteklerde: Önbellek isteği depolamamalıdır. Yanıtlarda: Önbellek yanıtın herhangi bir bölümünü depolamamalıdır. |
Önbelleğe almada rol oynayan diğer önbellek üst bilgileri aşağıdaki tabloda gösterilmiştir.
| Header | Function |
|---|---|
| Age | Yanıtın kaynak sunucuda oluşturulmasından veya başarıyla doğrulanmasından bu yana geçen süreyi saniye olarak tahmin eder. |
| Expires | Yanıtın eski olarak kabul edildiği süreyi belirtir. |
| Pragma | HTTP 1.0 önbellekleriyle geriye dönük uyumluluğu sağlamak için no-cache davranışını ayarlamak amacıyla vardır.
Cache-Control Başlık varsa, Pragma başlık yoksayılır. |
| Vary | Üst bilgi alanlarının tümü Vary hem önbelleğe alınmış yanıtın özgün isteğinde hem de yeni istekte eşleşmediği sürece önbelleğe alınmış yanıtın gönderilmemesi gerektiğini belirtir. |
HTTP tabanlı önbelleğe alma, istek Önbelleği Denetimi yönergelerine uyar
RFC 9111: HTTP Önbelleğe Alma (Bölüm 5.2. Cache-Control) belirtimi, istemci tarafından gönderilen geçerli Cache-Control bir üst bilgiyi kabul etmek için bir önbellek gerektirir. İstemci bir no-cache üst bilgi değeriyle istekte bulunabilir ve sunucuyu her istek için yeni bir yanıt oluşturmaya zorlayabilir.
HTTP önbelleğe alma hedefini dikkate alırsanız istemci Cache-Control isteği üst bilgilerini her zaman kabul etmeniz mantıklıdır. Resmi belirtim kapsamında önbelleğe alma, istemci, ara sunucu ve sunucu ağı genelinde istekleri karşılamanın gecikme süresini ve ağ ek yükünü azaltmaya yöneliktir. Kaynak sunucudaki yükü denetlemenin bir yolu olması şart değildir.
yanıt önbellekleme ara yazılımını kullanırken, ara yazılım resmî önbellekleme belirtimine uyduğundan geliştiricinin bu önbellekleme davranışı üzerinde hiçbir denetimi yoktur. .NET 7 ve üzeri, sunucu yükünü daha iyi denetlemek için output önbelleğe alma desteği içerir. Daha fazla bilgi için bkz. Çıktı önbelleğe alma.
ResponseCache özniteliği
Bu sınıf, ResponseCacheAttribute yanıt önbelleğe alma sürecinde uygun başlıkları ayarlamak için gerekli parametreleri belirtir.
Warning
Kimliği doğrulanmış istemciler için bilgi içeren içerik için önbelleğe almayı devre dışı bırakın. Önbelleğe alma yalnızca kullanıcının kimliğine veya kullanıcının oturum açıp açmadığına bağlı olarak değişmeyen içerik için etkinleştirilmelidir.
Bu özellik, VaryByQueryKeys depolanan yanıtı, verilen sorgu anahtarları listesinin değerlerine göre değiştirir. Joker karakterin (*) tek bir değeri sağlandığında, ara yazılım tüm istek sorgu dizesi parametrelerine göre yanıtları değişir.
Özelliği ayarlamak için yanıt önbelleğe alma ara yazılımının etkinleştirilmesi VaryByQueryKeys gerekir. Aksi takdirde, bir çalışma zamanı özel durumu oluşturulur. Özelliği için VaryByQueryKeys karşılık gelen bir HTTP üst bilgisi yok. özelliği, yanıt önbelleğe alma ara yazılımı tarafından işlenen bir HTTP özelliğidir. Ara yazılımının önbelleğe alınmış bir yanıt sunması için, sorgu dizesi ve sorgu dizesi değeri önceki bir istekle eşleşmelidir. Örneğin, aşağıdaki tabloda gösterilen istek ve sonuç sırasını göz önünde bulundurun.
| Request | Döndürülen kaynak |
|---|---|
http://example.com?key1=value1 |
Server |
http://example.com?key1=value1 |
Middleware |
http://example.com?key1=NewValue |
Server |
Sunucu ilk isteği döndürür ve ara yazılım isteği önbelleğe alır. Sorgu dizesi önceki (ilk) istekle eşleştiğinden ara yazılım ikinci isteği döndürür. Sorgu dizesi değeri önceki bir istekle eşleşmediğinden üçüncü istek ara yazılım önbelleğinde değil.
ResponseCacheAttribute sınıfı, bir IFilterFactory yapılandırmak ve oluşturmak için kullanılır (Microsoft.AspNetCore.Mvc.Internal.ResponseCacheFilter arabirimi aracılığıyla). , ResponseCacheFilter yanıtın uygun HTTP üst bilgilerini ve özelliklerini güncelleştirme işini gerçekleştirir. Filtre:
- Mevcut
Vary,Cache-ControlvePragmaüst bilgilerini kaldırır. - içinde ayarlanan ResponseCacheAttribute özelliklerine göre uygun üst bilgileri yazar.
- Özellik ayarlandıysa VaryByQueryKeys yanıt önbelleğe alma HTTP özelliğini güncelleştirir.
Üst bilgiyi değiştir
Bu üst bilgi yalnızca VaryByHeader özelliği ayarlandığında yazılır. Özellik, Vary özelliğinin değerine ayarlanır. Aşağıdaki örnek özelliğini VaryByHeader kullanır:
[ApiController]
public class TimeController : ControllerBase
{
[Route("api/[controller]")]
[HttpGet]
[ResponseCache(VaryByHeader = "User-Agent", Duration = 30)]
public ContentResult GetTime() => Content(
DateTime.Now.Millisecond.ToString());
Fiddler veya başka bir araçla yanıt başlıklarını görüntüleyin. Yanıt üst bilgileri şunlardır:
Cache-Control: public,max-age=30
Vary: User-Agent
Yukarıdaki kod, hizmet koleksiyonuna yanıt önbelleğe alma ara yazılım hizmetleri AddResponseCaching yönteminin eklenmesini gerektirir. Kod, uygulamayı uzantı yöntemiyle UseResponseCaching ara yazılımı kullanacak şekilde yapılandırıyor.
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
builder.Services.AddResponseCaching();
var app = builder.Build();
app.UseHttpsRedirection();
// UseCors must be called before UseResponseCaching
//app.UseCors();
app.UseResponseCaching();
app.UseAuthorization();
app.MapControllers();
app.Run();
NoStore ve Location.None özellikleri
NoStore özelliği diğer özelliklerin çoğunu geçersiz kılar. Bu özellik true olarak ayarlandığında, Cache-Control üst bilgisi no-store olarak ayarlanır. Eğer Location özelliği None olarak ayarlandıysa:
-
Cache-Controlüst bilgisino-store,no-cacheolarak ayarlanır. -
Pragmaüst bilgisino-cacheolarak ayarlanır.
NoStore özelliği false olarak ayarlanırsa ve Location özelliği None olarak ayarlanırsa, Cache-Control ve Pragma üst bilgileri no-cache olarak ayarlanır.
NoStore özelliği genellikle hata sayfaları için olarak true ayarlanır. Aşağıdaki kod, istemciye yanıtı depolamamasını belirten yanıt üst bilgileri oluşturur.
[Route("api/[controller]/ticks")]
[HttpGet]
[ResponseCache(Location = ResponseCacheLocation.None, NoStore = true)]
public ContentResult GetTimeTicks() => Content(
DateTime.Now.Ticks.ToString());
Yukarıdaki kod yanıtta aşağıdaki üst bilgileri içerir:
Cache-Control: no-store,no-cache
Pragma: no-cache
Uygulamanın tüm MVC denetleyici veya Sayfalar sayfası yanıtlarına ResponseCacheAttribute uygulamak için, Razor veya ile özniteliği ekleyin.
MVC uygulamasında aşağıdaki kodu ekleyin:
builder.Services.AddControllersWithViews().AddMvcOptions(options =>
options.Filters.Add(
new ResponseCacheAttribute
{
NoStore = true,
Location = ResponseCacheLocation.None
}));
Razor Pages uygulamaları için geçerli bir yaklaşım için GitHub dotnet/aspnetcore sorun #18890’a bakın). - . Sorundaki açıklama örneği, Minimal API'lerinin (ASP.NET Core sürüm 6.0) yayınını önceden belirten ASP.NET Core uygulamalar için geçerlidir. Sürüm 6.0 ve üzerini hedefleyen uygulamalar için örnekte builder.Services.AddSingleton... kullanılan hizmet kaydını Program.cs dosyasında olarak değiştirin.
Konum ve Süre özellikleri
Önbelleğe almayı etkinleştirmek için özelliği Duration pozitif bir değere ayarlanmalıdır ve Location (varsayılan) veya Anyolmalıdır Client . Çerçeve üst bilgiyi, yanıtın ardından Cache-Control konum değerine ayarlarmax-age.
Location özelliğinin seçenekleri, Any ve Client, sırasıyla Cache-Control başlık değerlerine public ve private olarak çevrilir.
NoStore ve Location.None bölümünde belirtildiği gibi, Location özelliğini ayarladığınızda, hem None hem de Cache-Control başlıklarını Pragma olarak ayarlar.
Location.Any (Cache-Control ayarı public olarak ayarlandığında) özelliği, istemcinin veya herhangi bir ara vekil sunucunun, yanıt önbelleğe alma ara yazılımı dahil, değeri önbelleğe alabileceğini belirtir.
Özellik ayarı
Önbellek denetimi üst bilgileri, istemcilere ve ara ara sunuculara yanıtların ne zaman ve nasıl önbelleğe alınacakları konusunda rehberlik sağlar. İstemcilerin ve proxy'lerin RFC 9111: HTTP Önbelleğe alma belirtimini kabul etmelerinin garantisi yoktur. Yanıt önbelleğe alma ara yazılımı her zaman belirtim tarafından belirtilen önbelleğe alma kurallarına uyar.
Aşağıdaki örnekte, Duration özelliği ayarlanıp Location özelliği varsayılan değerde bırakılarak oluşturulan başlıklar gösterilmektedir.
[Route("api/[controller]/ms")]
[HttpGet]
[ResponseCache(Duration = 10, Location = ResponseCacheLocation.Any, NoStore = false)]
public ContentResult GetTimeMS() => Content(
DateTime.Now.Millisecond.ToString());
Yukarıdaki kod yanıtta aşağıdaki üst bilgileri içerir:
Cache-Control: public,max-age=10
Önbellek profilleri
Birçok denetleyici eylemi özniteliğinde yanıt önbelleği ayarlarını yinelemek yerine, MVC sayfaları veya Razor Sayfaları ayarlanırken önbellek profilleri seçenek olarak yapılandırılabilir. Başvurulan önbellek profilinde bulunan değerler ResponseCacheAttribute tarafından varsayılan olarak kullanılır. Özniteliğinde belirtilen tüm özellikler, başvuruda bulunan önbellek profili değerlerini geçersiz kılar.
Aşağıdaki örnekte 30 saniyelik önbellek profili gösterilmektedir:
using Microsoft.AspNetCore.Mvc;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddResponseCaching();
builder.Services.AddControllers(options =>
{
options.CacheProfiles.Add("Default30",
new CacheProfile()
{
Duration = 30
});
});
var app = builder.Build();
app.UseHttpsRedirection();
// UseCors must be called before UseResponseCaching
//app.UseCors();
app.UseResponseCaching();
app.UseAuthorization();
app.MapControllers();
app.Run();
Aşağıdaki kod önbellek profiline Default30 başvurur:
[ApiController]
[ResponseCache(CacheProfileName = "Default30")]
public class Time2Controller : ControllerBase
{
[Route("api/[controller]")]
[HttpGet]
public ContentResult GetTime() => Content(
DateTime.Now.Millisecond.ToString());
[Route("api/[controller]/ticks")]
[HttpGet]
public ContentResult GetTimeTicks() => Content(
DateTime.Now.Ticks.ToString());
}
Default30 önbellek profili tarafından üretilen üst bilgi yanıtı şunları içerir:
Cache-Control: public,max-age=30
[ResponseCache] özniteliğini Razor Pages, MVC denetleyicileri ve MVC eylem yöntemlerine uygulayabilirsiniz.
Sayfalar Razor'da, UI uygulamaları ile kullanılan tarayıcılar yanıt önbelleğe almayı engellediğinden işleyici metotlarına öznitelik uygulayamazsınız. MVC eylem yönteminde, yöntem düzeyi öznitelikleri sınıf düzeyi özniteliklerde belirtilen ayarları geçersiz kılar.
Aşağıdaki kod, denetleyici düzeyinde ve yöntem düzeyinde özniteliğini uygular [ResponseCache] :
[ApiController]
[ResponseCache(VaryByHeader = "User-Agent", Duration = 30)]
public class Time4Controller : ControllerBase
{
[Route("api/[controller]")]
[HttpGet]
public ContentResult GetTime() => Content(
DateTime.Now.Millisecond.ToString());
[Route("api/[controller]/ticks")]
[HttpGet]
public ContentResult GetTimeTicks() => Content(
DateTime.Now.Ticks.ToString());
[Route("api/[controller]/ms")]
[HttpGet]
[ResponseCache(Duration = 10, Location = ResponseCacheLocation.Any, NoStore = false)]
public ContentResult GetTimeMS() => Content(
DateTime.Now.Millisecond.ToString());
}
İlgili içerik
Örnek kodu görüntüleme veya indirme (indirme)
Yanıt önbelleğe alma, bir istemcinin veya ara sunucunun web sunucusuna yaptığı istek sayısını azaltır. Yanıt önbelleğe alma, web sunucusunun yanıt oluşturmak için gerçekleştirdiği çalışma miktarını da azaltır. Yanıt önbelleğe alma, istemci, ara sunucu ve ara yazılımların yanıtları önbelleğe alma şeklini belirten üst bilgiler tarafından denetlenmektedir.
[ResponseCache] yanıt önbelleğe alma üst bilgilerini ayarlamaya katkıda bulunur. İstemciler ve ara proxy'ler RFC 9111: HTTP Önbelleğe Alma altındaki yanıtların önbelleğe alınması için başlıkları göz önünde bulundurmalıdır.
HTTP 1.1 Önbelleğe alma belirtimini izleyen sunucu tarafı önbelleğe alma için yanıt önbelleğe alma ara yazılımını kullanın. Ara yazılım, [ResponseCache] özelliklerini sunucu tarafı önbellekleme üst bilgilerini ayarlamak için kullanabilir.
HTTP tabanlı yanıt önbelleğe alma
RFC 9111: HTTP Önbelleğe Alma , İnternet önbelleklerinin nasıl davranması gerektiğini açıklar. Önbelleğe alma için kullanılan birincil HTTP üst bilgisi, önbellek yönergelerini belirtmek için kullanılan Önbellek Denetimi'dir. İstekler istemcilerden sunuculara doğru ilerledikçe ve yanıtlar sunuculardan istemcilere geri döndükçe yönergeler önbelleğe alma davranışını denetler. İstekler ve yanıtlar ara sunucularda taşınır ve proxy sunucuları da HTTP 1.1 Önbelleğe alma belirtimine uygun olmalıdır.
Ortak Cache-Control yönergeler aşağıdaki tabloda gösterilmiştir.
| Directive | Action |
|---|---|
| public | Önbellek yanıtı depolar. |
| private | Yanıt, paylaşılan önbellek tarafından depolanmamalıdır. Özel önbellek yanıtı depolayıp yeniden kullanabilir. |
| max-age | İstemci, yaşı belirtilen saniye sayısından büyük olan bir yanıtı kabul etmez. Örnekler: max-age=60 (60 saniye), max-age=2592000 (1 ay) |
| no-cache |
İsteklerde: Önbellek, isteği karşılamak için depolanmış yanıt kullanmamalıdır. Kaynak sunucu istemci için yanıtı yeniden oluşturur ve ara yazılım, depolanan yanıtı önbelleğinde güncelleştirir. Yanıtlarda: Yanıt, kaynak sunucuda doğrulama yapılmadan sonraki bir istek için kullanılmamalıdır. |
| no-store |
İsteklerde: Önbellek isteği depolamamalıdır. Yanıtlarda: Önbellek yanıtın herhangi bir bölümünü depolamamalıdır. |
Önbelleğe almada rol oynayan diğer önbellek üst bilgileri aşağıdaki tabloda gösterilmiştir.
| Header | Function |
|---|---|
| Age | Yanıtın kaynak sunucuda oluşturulmasından veya başarıyla doğrulanmasından bu yana geçen süreyi saniye olarak tahmin etme. |
| Expires | Yanıtın bayat olarak kabul edildiği süre. |
| Pragma | HTTP/1.0 önbellekleriyle geriye dönük uyumluluğu sağlamak için no-cache davranışını ayarlamaya yarar.
Cache-Control Başlık varsa, Pragma başlık yoksayılır. |
| Vary | Üst bilgi alanlarının tümü Vary hem önbelleğe alınmış yanıtın özgün isteğinde hem de yeni istekte eşleşmediği sürece önbelleğe alınmış yanıtın gönderilmemesi gerektiğini belirtir. |
HTTP tabanlı önbelleğe alma, istek Önbelleği Denetimi yönergelerine uyar
RFC 9111: HTTP Önbelleğe Alma (Bölüm 5.2. Cache-Control), istemci tarafından gönderilen geçerli Cache-Control bir üst bilgiyi kabul etmek için bir önbellek gerektirir. İstemci bir no-cache üst bilgi değeriyle istekte bulunabilir ve sunucuyu her istek için yeni bir yanıt oluşturmaya zorlayabilir.
HTTP önbelleğe alma hedefini dikkate alırsanız istemci Cache-Control isteği üst bilgilerini her zaman kabul etmeniz mantıklıdır. Resmi belirtim kapsamında önbelleğe alma, istemci, ara sunucu ve sunucu ağı genelinde istekleri karşılamanın gecikme süresini ve ağ ek yükünü azaltmaya yöneliktir. Kaynak sunucudaki yükü denetlemenin bir yolu olması şart değildir.
yanıt önbellekleme ara yazılımını kullanırken, ara yazılım resmî önbellekleme belirtimine uyduğundan geliştiricinin bu önbellekleme davranışı üzerinde hiçbir denetimi yoktur. Sunucu yükünü daha iyi denetlemek için çıktı önbelleğe alma desteği, ASP.NET Core'un gelecekteki bir sürümü için bir tasarım teklifidir. Daha fazla bilgi için Çıkış Önbelleğe Alma desteği ekleme (dotnet/aspnetcore #27387) başlıklı belgeye bakın.
ASP.NET Core'daki diğer önbelleğe alma teknolojisi
Bellek içi önbellek
Bellek içi önbelleğe alma, önbelleğe alınmış verileri depolamak için sunucu belleğini kullanır. Bu önbelleğe alma türü, oturum benzimi kullanan tek bir sunucu veya birden çok sunucu için uygundur. Oturum bağımlılığı, yapışkan oturumlar olarak da bilinir. Oturum benzimi, bir istemciden gelen isteklerin her zaman işlenmek üzere aynı sunucuya yönlendirildiğini gösterir.
Daha fazla bilgi için ASP.NET Core'da bellek içi önbelleğe alma ve Azure Application Gateway oturum bağımlılığı sorunlarını giderme konularına bakın.
Dağıtılmış Önbellek
Uygulama bir bulutta veya sunucu grubunda barındırıldığında verileri bellekte depolamak için dağıtılmış önbellek kullanın. Önbellek, istekleri işleyen sunucular arasında paylaşılır. İstemci için önbelleğe alınmış veriler varsa, istemci gruptaki herhangi bir sunucu tarafından işlenen bir istek gönderebilir. ASP.NET Core, SQL Server, Redis, Postgres ve NCache dağıtılmış önbellekleriyle çalışır.
Daha fazla bilgi için bkz . ASP.NET Core'da dağıtılmış önbelleğe alma.
Önbellek Etiketi Yardımcısı
İçeriği, Önbellek Etiketi Yardımcısı ile bir MVC görünümünden veya Razor Sayfasından önbelleğe alın. Önbellek Etiketi Yardımcısı, verileri depolamak için bellek içi önbelleğe alma kullanır.
Daha fazla bilgi için bkz . ASP.NET Core MVC'de Önbellek Etiketi Yardımcısı.
Dağıtılmış Önbellek Etiketi Yardımcısı
Dağıtılmış Cache Tag Helper ile dağıtılmış bulut veya web farm senaryolarındaki bir MVC görünümünden veya Razor Sayfasından içeriği önbelleğe alın. Dağıtılmış Önbellek Etiketi Yardımcısı, verileri depolamak için SQL Server, Redis veya NCache kullanır.
Daha fazla bilgi için bkz . ASP.NET Core'da Dağıtılmış Önbellek Etiketi Yardımcısı.
ResponseCache özniteliği
, ResponseCacheAttribute yanıt önbelleğe almada uygun üst bilgileri ayarlamak için gereken parametreleri belirtir.
Warning
Kimliği doğrulanmış istemciler için bilgi içeren içerik için önbelleğe almayı devre dışı bırakın. Önbelleğe alma yalnızca kullanıcının kimliğine veya kullanıcının oturum açıp açmadığına bağlı olarak değişmeyen içerik için etkinleştirilmelidir.
VaryByQueryKeys depolanan yanıtı verilen sorgu anahtarları listesinin değerlerine göre değişir. Tek bir * değeri sağlandığında, ara yazılım yanıtları tüm istek sorgu dizesi parametrelerine göre çeşitlendirir.
Özelliği ayarlamak için yanıt önbelleğe alma ara yazılımının etkinleştirilmesi VaryByQueryKeys gerekir. Aksi takdirde, bir çalışma zamanı özel durumu oluşturulur. Özelliği için VaryByQueryKeys karşılık gelen bir HTTP üst bilgisi yok. özelliği, yanıt önbelleğe alma ara yazılımı tarafından işlenen bir HTTP özelliğidir. Ara yazılımının önbelleğe alınmış bir yanıt sunması için, sorgu dizesi ve sorgu dizesi değeri önceki bir istekle eşleşmelidir. Örneğin, aşağıdaki tabloda gösterilen istek ve sonuç sırasını göz önünde bulundurun.
| Request | Result |
|---|---|
http://example.com?key1=value1 |
Sunucudan geri döndü. |
http://example.com?key1=value1 |
Middleware'den döndü. |
http://example.com?key1=value2 |
Sunucudan geri döndü. |
İlk istek sunucu tarafından döndürülür ve ara yazılımda önbelleğe alınır. sorgu dizesi önceki istekle eşleştiğinden ikinci istek ara yazılım tarafından döndürülür. Sorgu dizesi değeri önceki bir istekle eşleşmediğinden üçüncü istek ara yazılım önbelleğinde değil.
ResponseCacheAttribute bir IFilterFactory yapılandırmak ve oluşturmak için Microsoft.AspNetCore.Mvc.Internal.ResponseCacheFilter aracılığıyla kullanılır. , ResponseCacheFilter yanıtın uygun HTTP üst bilgilerini ve özelliklerini güncelleştirme işini gerçekleştirir. Filtre:
- Mevcut
Vary,Cache-ControlvePragmaüst bilgilerini kaldırır. - içinde ayarlanan ResponseCacheAttribute özelliklerine göre uygun üst bilgileri yazar.
- Ayarlandıysa VaryByQueryKeys yanıt önbelleğe alma HTTP özelliğini güncelleştirir.
Vary
Bu üst bilgi yalnızca VaryByHeader özelliği ayarlandığında yazılır. Özellik, Vary değerine ayarlanır. Aşağıdaki örnek özelliğini VaryByHeader kullanır:
[ResponseCache(VaryByHeader = "User-Agent", Duration = 30)]
public class Cache1Model : PageModel
{
Örnek uygulamayı kullanarak, tarayıcının ağ araçlarıyla yanıt üst bilgilerini görüntüleyin. Aşağıdaki yanıt üst bilgileri Cache1 sayfa yanıtıyla gönderilir:
Cache-Control: public,max-age=30
Vary: User-Agent
NoStore ve Location.None
NoStore diğer özelliklerin çoğunu geçersiz kılar. Bu özellik true olarak ayarlandığında, Cache-Control üst bilgisi no-store olarak ayarlanır. Eğer LocationNone olarak ayarlandıysa
-
Cache-Contrololarak ayarlanırno-store,no-cache. -
Pragmaolarak ayarlanırno-cache.
Eğer NoStorefalse ise ve LocationNone ise, Cache-Control, Pragma olarak no-cache ayarlanır.
NoStore genellikle hata sayfaları için olarak ayarlanır true . Örnek uygulamadaki Cache2 sayfası, istemciye yanıtı depolamamasını belirten yanıt üst bilgileri oluşturur.
[ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
public class Cache2Model : PageModel
{
Örnek uygulama aşağıdaki üst bilgileri içeren Cache2 sayfasını döndürür:
Cache-Control: no-store,no-cache
Pragma: no-cache
Uygulamayı, uygulamanın tüm MVC denetleyicilerine veya Sayfalar sayfası yanıtlarına uygulamak için, bunu bir
MVC uygulamasında:
services.AddMvc().AddMvcOptions(options =>
options.Filters.Add(
new ResponseCacheAttribute
{
NoStore = true,
Location = ResponseCacheLocation.None
}));
Sayfalar uygulamalarına uygulanan bir yaklaşım için Razor bkz . MVC genel filtre listesine ekleme ResponseCacheAttribute Sayfalar için Razor geçerli değil (dotnet/aspnetcore #18890).
Konum ve Süre
Önbelleği etkinleştirmek için, Duration pozitif bir değere ayarlanmalıdır ve Location ya varsayılan değer olan Any ya da Client olmalıdır. Çerçeve üst bilgiyi, yanıtın ardından Cache-Control konum değerine ayarlarmax-age.
Location'nin seçenekleri Any ve Client, sırasıyla Cache-Control üst bilgi değerlerine public ve private olarak çevrilir. NoStore ve Location.None bölümünde belirtildiği gibi, ayarlandığında, hem Location hem de None başlıkları Cache-Control olarak ayarlanır.
Location.Any(Cache-Control olarak publicayarlanır), istemcinin veya herhangi bir ara ara ara sunucusunun, yanıt önbelleğe alma ara yazılımı da dahil olmak üzere değeri önbelleğe alabileceğini gösterir.
Location.Client(Cache-Control olarak privateayarlanır) değeri yalnızca istemcinin önbelleğe alabileceğini gösterir. Hiçbir ara önbellek, yanıt önbelleğe alma ara yazılımı da dahil olmak üzere değeri önbelleğe almamalıdır.
Önbellek denetimi üst bilgileri yalnızca istemcilere ve ara proxy'lere yanıtların ne zaman ve nasıl önbelleğe alınacakları konusunda rehberlik sağlar. İstemcilerin ve proxy'lerin RFC 9111: HTTP Önbelleğe Alma'ya saygı göstereceğinin garantisi yoktur. Yanıt önbelleğe alma ara yazılımı her zaman belirtim tarafından belirtilen önbelleğe alma kurallarına uyar.
Aşağıdaki örnek, örnek uygulamadaki Cache3 sayfa modelini ve Duration ayarlanıp Location varsayılanı bırakılarak üretilen başlıkları göstermektedir.
[ResponseCache(Duration = 10, Location = ResponseCacheLocation.Any, NoStore = false)]
public class Cache3Model : PageModel
{
Örnek uygulama aşağıdaki üst bilgiyle Cache3 sayfasını döndürür:
Cache-Control: public,max-age=10
Önbellek profilleri
Birçok denetleyici eylem özniteliklerinde yanıt önbelleği ayarlarını yinelemek yerine, önbellek profilleri, MVC/Razor Sayfaları Startup.ConfigureServices ayarlarken seçenekler olarak yapılandırılabilir. Başvurulan önbellek profilinde bulunan değerler, ResponseCacheAttribute tarafından varsayılan olarak kullanılır ve öznitelikte belirtilen herhangi bir özellik tarafından geçersiz kılınır.
Önbellek profili ayarlama. Aşağıdaki örnekte, örnek uygulamanın içinde 30 saniyelik bir önbellek profili gösterilmektedir Startup.ConfigureServices:
public void ConfigureServices(IServiceCollection services)
{
services.AddRazorPages();
services.AddMvc(options =>
{
options.CacheProfiles.Add("Default30",
new CacheProfile()
{
Duration = 30
});
});
}
Örnek uygulamanın Cache4 sayfa modeli önbellek profiline Default30 başvurur:
[ResponseCache(CacheProfileName = "Default30")]
public class Cache4Model : PageModel
{
ResponseCacheAttribute aşağıdakilere uygulanabilir:
- Razor Sayfalar: Öznitelikler işleyici yöntemlerine uygulanamaz.
- MVC denetleyicileri.
- MVC eylem yöntemleri: Yöntem düzeyi öznitelikler, sınıf düzeyi özniteliklerde belirtilen ayarları geçersiz kılar.
Önbellek profili tarafından Cache4 sayfa yanıtına uygulanan sonuçta elde edilen Default30 üst bilgi:
Cache-Control: public,max-age=30
İlgili içerik
- Yanıtları Önbelleklerde Depolama
- RFC 9111: HTTP Önbelleğe Alma (Bölüm 5.2. Önbellek Denetimi)
- ASP.NET Core'da bellek içi önbellek
- ASP.NET Core'da dağıtılmış önbelleğe alma
- ASP.NET Core'da değişiklik belirteçleriyle değişiklikleri algılama
- ASP.NET Core'da Response önbelleğe alma ara yazılımı
- ASP.NET Core MVC'de Önbellek Etiketi Yardımcısı
- ASP.NET Core'da Dağıtılmış Önbellek Etiketi Yardımcısı
ASP.NET Core