Share via

Pomocná rutina značky obrázku v ASP.NET Core

  • Článek

Autor: Peter Kellner

Pomocná rutina značky obrázku <img> vylepšuje značku tak, aby poskytovala chování při ukládání do mezipaměti pro statické soubory obrázků.

Řetězec pro busting mezipaměti je jedinečná hodnota představující hodnotu hash souboru statického obrázku připojeného k adrese URL prostředku. Jedinečný řetězec vyzve klienty (a některé proxy servery) k opětovnému načtení image z hostitelského webového serveru, nikoli z mezipaměti klienta.

Pokud je zdrojem image (src) statický soubor na hostitelském webovém serveru:

  • Jedinečný řetězec pro busting mezipaměti se připojí jako parametr dotazu ke zdroji image.
  • Pokud se soubor na webovém serveru hostitele změní, vygeneruje se jedinečná adresa URL požadavku, která obsahuje aktualizovaný parametr požadavku.

Přehled pomocných rutin značek najdete v tématu Pomocné rutiny značek v ASP.NET Core.

Atributy pomocné rutiny značky obrázku

src

K aktivaci pomocné rutiny značky obrázku src je atribut vyžadován u elementu <img> .

Zdroj image (src) musí odkazovat na fyzický statický soubor na serveru. Pokud se jedná src o vzdálený identifikátor URI, nevygeneruje se parametr řetězce dotazu pro busting mezipaměti.

asp-append-version

Pokud asp-append-version je zadána s hodnotou spolu s true atributem src , je vyvolána pomocná rutina značky obrázku.

Následující příklad používá pomocníka značky obrázku:

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

Pokud statický soubor existuje v adresáři /wwwroot/images/, je vygenerovaný kód HTML podobný následujícímu (hodnota hash se bude lišit):

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

Hodnota přiřazená parametru v je hodnota asplogo.png hash souboru na disku. Pokud webový server nemůže získat přístup pro čtení ke statickému souboru, nepřidá se do src atributu v vykreslené značkě žádný v parametr.

Pomocná rutina značek, která vygeneruje verzi statického souboru mimo wwwroot, najdete v tématu Obsluha souborů z více umístění.

Chování ukládání do mezipaměti hash

Pomocník značky obrázku používá zprostředkovatele mezipaměti na místním webovém serveru k uložení počítané Sha512 hodnoty hash daného souboru. Pokud se o soubor žádá vícekrát, hodnota hash se nepřepočítá. Mezipaměť zneplatní sledovací proces souboru, který je připojený k souboru při výpočtu hodnoty hash souboru Sha512 . Když se soubor na disku změní, vypočítá se nová hodnota hash a bude uložena do mezipaměti.

Další prostředky