Bevezetés a tag-helper sejtek (tag segítők) - dokumentációt 1 mag

Tag Segítők, hogy a szerver oldali kódot, hogy részt vegyenek a létrehozása és bemutatása a HTML elemek a Razor fájlokat. Például a beépített ImageTagHelper lehet csatolni egy verzió számot a kép nevét. Amikor egy kép megváltozik, a szerver egy új, egyedi változata a képet, hogy az ügyfél garantáltan megkapja az aktuális verzió a kép (ahelyett, hogy a cache kép). Általános célokra sok beépített Tag Segítők - például létrehozására formák, linkek, letöltések, stb -, és ezek közül sok kapható nyitott GitHub tárolók és NuGet csomagokat. Tag segítők dolgoznak HTML elemek alapján az elem nevét, attribútum neve, vagy a szülő tag. Például a beépített LabelTagHelper tud dolgozni HTML elem . ha LabelTagHelper attribútumok érvényesek. Ha ismeri a HTML helper módszereket. akkor rájönnek, hogy Tag Segítők csökkenti explicit közötti átmenetek HTML és C # -ban Razor látható. Lásd. Tag Segítők képest segédeszköz HTML.

A legtöbb beépített Tag segítők célja, hogy meglévő HTML-elemeket, és az attribútumok a kliens oldalon. Például, elem . Használt sok előadások a Views / Account mappában. Ez magában foglalja az Asp-attribútum. amely beolvassa a nevét a neve a megadott tulajdonság a bemutatott modell HTML. A következő jelölés Razor:

generálja a következő HTML:

Képesség asp-rendelkezésre álló ingatlan esetében LabelTagHelper. Lásd. Létrehozása elemek Tag Helper.

Tag segítők által ellenőrzött kombinációja # 64; addTagHelper. # 64; removeTagHelper és jel opt-out "!".

# 64; addTagHelper teszi Tag Segítők dostupnymi¶

Ha létrehoz egy új ASP.NET Core nevű alkalmazást AuthoringTagHelpers (hitelesítés nélkül), a projekt a következő fájl Views / _ViewImports.cshtml kerül ki:

irányelv # 64; addTagHelper Tag Segítők elérhetővé teszi a látványt. Ebben az esetben a benyújtás fájl Views / _ViewImports.cshtml. amely alapértelmezés öröklődik minden fájlt beadványok a Views mappa almappákat; így Tag segítők állnak rendelkezésre minden. A kód szintaxisát használjuk a tetején „*” jelzi, hogy minden Tag segítők a megadott szerkezetet (Microsoft.AspNet.Mvc.TagHelpers) lesz elérhető az egyes nézetekben a fájl vagy alkönyvtár a Views könyvtárban. Az első paraméter után # 64; addTagHelper mondja Tag Segítők kell letölteni (az általunk használt „*” az összes Tag segítők), a második paraméter „Microsoft.AspNet.Mvc.TagHelpers” jelzi az összeállítás, amely a Tag segítők. Microsoft.AspNet.Mvc.TagHelpers - olyan beágyazott Tag segítők.

Ahhoz, hogy használni az összes Tag segítők ebben a projektben (amely létrehoz egy építmények AuthoringTagHelpers), akkor tegye a következőket:

Ha a projekt tartalmaz EmailTagHelper az alapértelmezett névteret (AuthoringTagHelpers.TagHelpers.EmailTagHelper), akkor a teljes név (FQN) Tag Helper elemek:

Fel a címke Helper egy képviselet FQN, akkor először hozzá FQN (AuthoringTagHelpers.TagHelpers.EmailTagHelper), majd a szerelvény neve (AuthoringTagHelpers). A legtöbb fejlesztő szívesebben használják a helyettesítő szintaxis - „*”. A szintaxis helyettesítő karakterek segítségével be egy helyettesítő „*”, mint egy utótag FQN. Például néhány a következő irányelveket hozzá EmailTagHelper:

Mint korábban említettük, a mellett irányelvek # 64; addTagHelper a nézetek / _ViewImports.cshtml fájl nem elem Tag Helper elérhető az összes nézetet a Nézet fájlok és alkönyvtárak a könyvtár. Használhatja az irányelv # 64; addTagHelper egyedi nézet fájlt, ha szeretné, hogy a tételt Tag Helper csak ezekben ábrázolások.

# 64; removeTagHelper eltávolítja Tag Helpers¶

-ban # 64; removeTagHelper van egyforma két lehetőség van, hogy a # 64; addTagHelper. és ez az utasítás törli a korábban hozzáadott elem Tag Helper. Például ha alkalmazza # 64; removeTagHelper adott nézetben, akkor távolítsa el ezt a véleményt adott Tag Helper. használata # 64; removeTagHelper a nézetek / mappa / fájl _ViewImports.cshtml eltávolítja bizonyos eleme Tag Segítő minden megnézve a mappában.

Ellenőrzése a Tag segítő elemek felhasználásával _ViewImports.cshtml fájlba ¶

Tetszőleges _ViewImports.cshtml prezentációs mappát és megjelenítési motor egészíti ki irányelv _ViewImports.cshtml fájlt azokat, amelyek a nézetek / _ViewImports.cshtml fájlt. Ha felvesz egy üres nézetek / Home / _ViewImports.cshtml Otthon fájlok megtekintéséhez. semmi sem fog változni, mert _ViewImports.cshtml fájl választható. bármilyen irányelv # 64; addTagHelper. hogy adjunk a nézetek / Home / _ViewImports.cshtml fájlt (és ez nem az alapértelmezett a nézetek / _ViewImports.cshtml fájl) hatására a Tag segítők csak a saját mappájába.

Egyenkénti törlése elementov¶

Ön kikapcsolhatja a Tag Segítő szintjén opt-out ( „!”) Elem a szimbólum. Például, e-mail érvényesítés le van tiltva ez a szimbólum:

használata # 64; tagHelperPrefix kifejezetten a Tag Helper¶

irányelv # 64; tagHelperPrefix lehetővé teszi, hogy adjon meg egy címkét előtagot lehetővé Tag segítő Tag-segéd és közvetlenül használható. Az alábbi ábra Tag Helper előtag beállítása „th:”, úgy, hogy csak azokat az elemeket, hogy használja az előtag „th:”, támogatása Tag segítők. elemekben és Tag Helper egy előtagot és az elem ez nem az.

Szabályok hierarchia alkalmazni # 64; addTagHelper. is alkalmazni kell, # 64; tagHelperPrefix.

Amikor létrehoz egy új ASP.NET alkalmazás Visual Studio, majd a „Microsoft.AspNet.Tooling.Razor” hozzáadott project.json fájlt. Ez a csomag egészíti ki a Tag segítő eszköz.

Ön nem csak kap HTML segítség, de az is lehet látni az ikont (szimbólum „# 64,” a "<>„Alatta).

Ez azt mutatja, hogy az elemen, amelynek célja Tag segítők. Tiszta HTML elemek (például, fieldset) kijelző ikon "<>”.

Tiszta HTML tag jelenik meg (az alapszíneket, Visual Studio) barna színű, attribútumok - piros és attribútum értékeket - kék.

IntelliSense lehetővé teszi, hogy töltse ki a kifejezés a kiválasztott érték:

A bevezetés után az attribútum Tag Helper, tag és attribútum betűtípus cserélni. Ha az alap színes programok Visual Studio „Blue” vagy „Light” szín lesz lila. Ha a rendszer „Dark”, a szín gazdag türkiz. Itt szoktunk az alapértelmezett sémát.

Használhatja gyorsbillentyűket Visual Studio CompleteWord (Ctrl + szóköz alapértelmezés) a dupla idézőjelek ( „”), és most a C #. IntelliSense megjeleníti valamennyi módszer és az oldal tulajdonságainak modell szerint. Módszerek és tulajdonságok állnak rendelkezésre, mint az a típusú tulajdonságok ModelExpression. Az alábbi kép azt szerkesztés képviselet Register. hogy mi van elérhető RegisterViewModel.

IntelliSense tulajdonságainak megtekintéséhez és módszer áll rendelkezésre a modell. IntelliSense segít kiválasztani a CSS osztály:

Tag Segítők csatolt HTML elemek a Razor kilátás, míg a HTML helper módszerekre van a HTML Razor nézeteit. Képzeljük el a következő címkét Razor, amely létrehoz egy HTML címke CSS osztály „felirat”:

„Kukac” jel ( # 64; ) Azt mondja Razor, ez tetején a kódot. A következő két paraméter ( „Keresztnév” és a „First Name:”) vannak húrok, úgyhogy IntelliSense segítség itt nem lehet. Az utolsó érv:

A LabelTagHelper ugyanazt az elrendezést felírható, mint ez:

IntelliSense segít minden regisztrálni. LabelTagHelper is állítja a content attribútum értéke asp-for ( "Keresztnév") a "First Name"; alakítja CamelCase tulajdonságok kifejezést, amely egy tulajdonság nevét egy hely, ahol minden van írva nagybetűvel. Amikor a következő jelölést:

Ez a technika nem használható, ha új tartalommal . Például:

A következő kód egy részét űrlap elküldése Views / Account / Register.cshtml Razor, generált ASP.NET MVC 4.5.x sablon tartalmazza a Visual Studio.

Megjelenik egy szürke háttér. A legtöbb jelölést képviselet Regisztráció a C # kódot. Hasonlítsa össze a megfelelője amelyet Tag Segítők:

Ügyeljen arra, hogy az E-mail csoport:

Egyes attribútumokat „Asp-” az értéke „E-mail”, de a „Email” nem karakterlánc. Ebben az összefüggésben a „Email” - ez a tulajdonság a modell kifejezése C # RegisterViewModel.

• Tag segítők nem tartoznak az elemet, amelyhez kapcsolódik; ők csak részt vesz a térképészeti és elem tartalma. ASP.NET Web Server ellenőrzéseket nyilvánították, és felszólította az oldalon.
• A webszerver ellenőrzi szokatlan életciklus, ami megnehezíti, hogy fejlesszünk és teszteljünk.
• Webszerver ellenőrzés lehetővé teszi, hogy adjunk további funkciókat a DOM elemeket. Tag Segítők nem.
• Webszerver ellenőrzések közé tartozik az automatikus észlelése böngészőt. Tag segítők nem tud semmit a böngésző.
• Több címke Segítők is dolgozhat egy és ugyanazt a tételt (lásd. Hogyan kerüljük el a konfliktus Tag Helper) és webszerver ellenőrzéseket nem lehet kombinálni.
• Tag Segítők megváltoztathatja a címkét, és összefüggésben HTML elemeket, amelyekhez kapcsolódik, de nem befolyásolja közvetlenül semmi mást az oldalon. Webszerver ellenőrzés műveletet tud végrehajtani, amelyek befolyásolják más részein az oldal, és ez néha okozhat mellékhatásokat.
• Webszerver ellenőrzés átalakítani stringeket tárgyakat. A Tag Segítők dolgozik natívan C #, így nem kell konvertálni.
• Webszerver ellenőrzések segítségével System.ComponentModel. hogy hajtsák végre a viselkedését alkatrészek a tervezési idő és futás közben. System.ComponentModel tartalmazza az alapot osztályok és interfészek végrehajtási attribútumok és típusú átalakítás, amely összeköti az adatforrások és alkatrészek. Tag Segítők örökölt TagHelper. és az alap TagHelper kategóriában, csak két módszer - a folyamat és ProcessAsync.

Testre szabhatja a betűtípus és a szín a Tools> Options> Környezet> betűtípusok és színek: