ASP.NET Core'da Görüntü Etiketi Yardımcısı

  • Makale

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 wwwrootbir 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