ASP.NET Core'da Görüntü Etiketi Yardımcısı
Yayımlayan Peter Kellner
Görüntü Etiketi Yardımcısı, statik görüntü dosyaları için önbellekte yakalama davranışı sağlamak üzere etiketi geliştirir <img>
.
Önbelleğe alma dizesi, varlığın URL'sine eklenen statik görüntü dosyasının karması temsil eden benzersiz bir değerdir. Benzersiz dize, istemcilerden (ve bazı proxy'lerden) görüntüyü istemcinin önbelleğinden değil ana bilgisayar web sunucusundan yeniden yüklemelerini ister.
Görüntü kaynağı (src
) konak web sunucusunda statik bir dosyaysa:
- Benzersiz bir önbelleğe alma dizesi, görüntü kaynağına sorgu parametresi olarak eklenir.
- Konak web sunucusundaki dosya değişirse, güncelleştirilmiş istek parametresini içeren benzersiz bir istek URL'si oluşturulur.
Etiket Yardımcıları'na genel bakış için, bkz. ASP.NET Core'da Etiket Yardımcıları.
Görüntü Etiketi Yardımcı Öznitelikleri
src
Görüntü Etiketi Yardımcısı'nı src
etkinleştirmek için özniteliği öğesinde <img>
gereklidir.
Görüntü kaynağı (src
) sunucudaki fiziksel statik bir dosyaya işaret etmelidir. src
uzak bir URI ise, önbelleğe alma sorgu dizesi parametresi oluşturulmaz.
asp-append-version
asp-append-version
Bir öznitelikle birlikte bir true
değerle src
belirtildiğinde, Görüntü Etiketi Yardımcısı çağrılır.
Aşağıdaki örnekte Bir Görüntü Etiketi Yardımcısı kullanılır:
<img src="~/images/asplogo.png" asp-append-version="true">
Statik dosya /wwwroot/images/ dizininde varsa, oluşturulan HTML aşağıdakine benzer (karma farklı olacaktır):
<img src="/images/asplogo.png?v=Kl_dqr9NVtnMdsM2MUg4qthUnWZm5T1fCEimBPWDNgM">
parametresine v
atanan değer, disk üzerindeki dosyanın karma değeridir asplogo.png
. Web sunucusu statik dosyaya okuma erişimi alamıyorsa, işlenen işaretlemede özniteliğine src
parametre v
eklenmez.
Etiket Yardımcısı'nın dışında wwwroot
bir statik dosya için sürüm oluşturması için bkz. Birden çok konumdan dosya sunma
Karma önbelleğe alma davranışı
Görüntü Etiketi Yardımcısı, belirli bir dosyanın hesaplanan Sha512
karması depolamak için yerel web sunucusundaki önbellek sağlayıcısını kullanır. Dosya birden çok kez istenirse karma yeniden hesaplanmamıştır. Önbellek, dosyanın karması hesaplandığında dosyaya eklenen bir dosya Sha512
izleyicisi tarafından geçersiz kılınır. Dosya diskte değiştiğinde yeni bir karma hesaplanır ve önbelleğe alınır.
Ek kaynaklar
ASP.NET Core
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin