Bagikan melalui

Pembantu Tag Gambar di ASP.NET Core

  • Artikel

Oleh Peter Kellner

Pembantu Tag Gambar meningkatkan <img> tag untuk menyediakan perilaku cache-busting untuk file gambar statis.

String cache-busting adalah nilai unik yang mewakili hash file gambar statis yang ditambahkan ke URL aset. String unik meminta klien (dan beberapa proksi) untuk memuat ulang gambar dari server web host dan bukan dari cache klien.

Jika sumber gambar (src) adalah file statis di server web host:

  • String cache-busting unik ditambahkan sebagai parameter kueri ke sumber gambar.
  • Jika file di server web host berubah, URL permintaan unik dihasilkan yang menyertakan parameter permintaan yang diperbarui.

Untuk gambaran umum tentang Pembantu Tag, lihat Pembantu Tag di ASP.NET Core.

Atribut Pembantu Tag Gambar

src

Untuk mengaktifkan Image Tag Helper, src atribut diperlukan pada <img> elemen .

Sumber gambar (src) harus menunjuk ke file statis fisik di server. src Jika adalah URI jarak jauh, parameter string kueri cache-busting tidak dihasilkan.

asp-append-version

Ketika asp-append-version ditentukan dengan true nilai bersama dengan src atribut, Pembantu Tag Gambar dipanggil.

Contoh berikut menggunakan Pembantu Tag Gambar:

<img src="~/images/asplogo.png" asp-append-version="true">

Jika file statis ada di direktori /wwwroot/images/, HTML yang dihasilkan mirip dengan yang berikut (hash akan berbeda):

<img src="/images/asplogo.png?v=Kl_dqr9NVtnMdsM2MUg4qthUnWZm5T1fCEimBPWDNgM">

Nilai yang ditetapkan ke parameter v adalah nilai asplogo.png hash file pada disk. Jika server web tidak dapat memperoleh akses baca ke file statis, tidak ada v parameter yang ditambahkan ke src atribut dalam markup yang dirender.

Agar Pembantu Tag menghasilkan versi untuk file statis di luar wwwroot, lihat Menyajikan file dari beberapa lokasi

Perilaku penembolokan hash

Pembantu Tag Gambar menggunakan penyedia cache di server web lokal untuk menyimpan hash terhitung Sha512 dari file tertentu. Jika file diminta beberapa kali, hash tidak dihitung ulang. Cache tidak valid oleh pengamat file yang dilampirkan ke file saat hash file Sha512 dihitung. Ketika file berubah pada disk, hash baru dihitung dan di-cache.

Sumber Daya Tambahan: