MVC+EF Core 完整教程20--tag helper詳解

来源:https://www.cnblogs.com/miro/archive/2019/08/13/11343710.html
-Advertisement-
Play Games

之前我們有一篇:“動態生成多級菜單”,對使用Html Helper做了詳細講述,並且自定義了一個菜單的 Html Helper: https://www.cnblogs.com/miro/p/5541086.html Html Helper是關聯前後端的一個核心組件,後面的ASP.NET Core ...


 

之前我們有一篇:“動態生成多級菜單”,對使用Html Helper做了詳細講述,並且自定義了一個菜單的 Html Helper: https://www.cnblogs.com/miro/p/5541086.html

Html Helper是關聯前後端的一個核心組件,後面的ASP.NET Core 又推出了Tag Helper,  作用和Html Helper很類似。

一般來說,如果作用類似,後推出的都會做一些改進,我們先來看下兩者的比較。

一、Html helper 和 Tag Helper 對比

先來一個比較例子:

下麵用 Html Helper 創建一個 lable

@Html.Label("FirstName", "First Name:", new {@class="caption"})

 

再來看實現同樣標簽的 tag helper

<label class="caption" asp-for="FirstName"></label>

 

可以看到 Html Helper的語法是作為一個方法 @Html.XXX(各種參數 , 其他參數 …)

來調用的。

 

上面 Html Helper例子中的方法有三個參數,前面兩個是字元串,最後一個是匿名對象( 用作html的屬性,new {@class="caption"} )

 

而 Tag Helper 和原生的html標簽很像,只不過增加了一些特有的屬性(asp-開頭的attribute)。

如果你用vs進行編輯時會發現,Html Helper 沒有智能提示(像字元串,匿名對象這些沒辦法智能提示),Tag Helper則可以智能提示。

另外,很明顯我們可以看出,Tag Helper的寫法更加乾凈,可讀性和維護性都比 Html Helper好。

如果熟悉前端,即使不熟悉c#,也能很容易看懂進行前後端協作開發。

我們簡單小結一下,主要有這兩點:

1、Tag Helper 有智能提示

2、Tag Helper可讀性好,易於分工合作

說明:

Tag Helper不能完全取代Html Helper, 不是每個Html Helper都有對應的Tag Helper

 

下麵我們直接動手來開發一個自己的Tag Helper(方便起見,我們接著之前的VCDemo這個項目改)。

二、自定義一個 Tag Helper

場景:

我們模擬稍微複雜一點的場景,不僅僅是簡單的改變一下標簽屬性,我們定義一個可以接收數據的Tag Helper。

我們定義一個類用來放置網站信息,包括版本號,版權聲明,以及聲明日期。

然後定義一個Tag Helper,接收這個類的數據。

 

前置準備

我們先配置下Tag Helper的作用域,讓我們自定義的Tag Helper可以在 view中被識別到。

預設的配置文件在 Views文件夾下的 _ViewImports.cshtml 中。

打開它,可以看到已經有

@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers

 

我們通過 @addTagHelper 使得tag helper在view中被識別。

第一個參數是要使用的位置,第二個參數是程式集。

使用通配符*, 代表指定程式集(Microsoft.AspNetCore.Mvc.TagHelpers)下的所有的tag helpers在當前Views文件夾及子文件夾下均可用。

我們仿照它的樣子添加一行:

@addTagHelper *, VCDemo

讓我們自己的程式集VCDemo下的tag helpers也都可用。

 

 

 

步驟

1、先定義一個類 Models/WebsiteInfo.cs ,用來放置網站信息。

    public class WebsiteInfo

    {

        public Version Version { get; set; }

        public int CopyrightYear { get; set; }

        public string PoweredBy { get; set; }

    }

 

2、新建文件夾 TagHelpers 用來放置自定義的 tag helper

3、在文件夾中新建類 WebsiteInfoTagHelper,繼承於TagHelper,實現Process方法。

    public class WebsiteInfoTagHelper : TagHelper

    {

        public WebsiteInfo Info { get; set; }

 

        public override void Process(TagHelperContext context, TagHelperOutput output)

        {

            output.TagName = "section";

            output.Content.SetHtmlContent(

               $@"<ul><li><strong>Version:</strong> {Info.Version}</li>

            <li><strong>Copyright Year:</strong> {Info.CopyrightYear}</li>

            <li><strong>Powered by:</strong> {Info.PoweredBy}</li></ul>");

            output.TagMode = TagMode.StartTagAndEndTag;

        }

    }

 

美元符號$ 指定了後面可以使用占位符{}插入數據, 如果不使用 $ 後面的{}就是普通的字元串。

使用時傳入了 WebsiteInfo對象, {Info.Version} 就會替代成相應的值。

4、我們在home/index上添加如下內容:

<h3>以下為版權聲明</h3>

@{ WebsiteInfo websiteInfo = new WebsiteInfo

    {

        Version = new Version(3, 0),

        CopyrightYear = 2019,

        PoweredBy = "編程小紙條"

    };

}

<website-info info="@websiteInfo" />

 

 

說明:

最後一行代碼:

<website-info info="@websiteInfo" />

1、這個info屬性 不是單純的字元串,是一個類,非字元串的屬性可以把“@”省略,即寫成這樣 <website-info info="websiteInfo" /> 也是可以的。

2、有一個約定,我們之前定義的 tag helper是WebsiteInfoTagHelper:

2.1 我們在前端使用時,首先去掉TagHelper尾碼,變成 WebsiteInfo

2.2 然後將WebsiteInfo這種Pascal case的風格,轉換成 Kebab case的風格,website-info, 變成:<website-info info="@websiteInfo" />

 

請參考 stackoverflow各種風格說明:

Pascal Case: SomeSymbol

Camel Case: someSymbol

Snake case:  some_symbol

Kebab case:  some-symbol

https://stackoverflow.com/questions/11273282/whats-the-name-for-hyphen-separated-case/12273101#12273101

 

運行結果:

 

 

 

三、另外一個小提示

VS編輯器對view中字體做了一些區別

1、單純的html標簽(tag)是灰色字體,屬性(attributes)是紅色字體,屬性值(attribute values)是藍色字體。如下

 

 

2、tag helper相關的屬性是加粗紫色, 例如

 

 

3、C#代碼帶有灰色背景色,如下方框處

 

祝 學習進步 :)

 

P.S. 系列文章列表:https://www.cnblogs.com/miro/p/3777960.html

 

 


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 一、Web Service 1、定義 是可以接收從Internet上的其他系統中傳遞的請求,是一種輕量級的獨立的通訊技術, 能使得運行在不同機器上的不同應用無須藉助附加的、專門的第三方軟體或硬體, 就可相互交換數據或集成。所以它是一個平臺獨立,低耦合,自包含,基於可編程的Web應用程式,適用於開發分 ...
  • 後端處理:var callback=context.Request.QueryString["callback"].ToString(); context.Response.Write($"{callback}({SerializeObject(result)})"); result為返回的數據 前 ...
  • (雙擊全屏播放) 一、前言 為什麼選擇Hyper-V? windowns自帶,免費 基礎環境 二、虛擬機配置 下載CentOS7鏡像 https://www.centos.org/download/ 此次安裝使用的版本為:CentOS-7-x86_64-Minimal-1611.iso 打開Hype ...
  • PostgreSQL是一個功能強大的開源資料庫系統。它支持了大多數的SQL:2008標準的數據類型,包括整型、數值值、布爾型、位元組型、字元型、日期型、時間間隔型和時間型,它也支持存儲二進位的大對像,包括圖片、聲音和視頻。PostgreSQL對很多高級開發語言有原生的編程介面,如C/C++、Java、... ...
  • 大家好,前幾天因工作需要要開發一個基於WinForm的小程式。其中要用到分頁,最開始的想法找個第三方的dll用一下,但是後來想了想覺得不如自己寫一個玩一下 之前的web開發中有各式各樣的列表組件基本都帶有分頁功能,筆者早先也自己寫過B/S端的分頁組件(利用jquery純前端方式)。對於WinForm ...
  • Virtual方法(虛方法) Virtual方法(虛方法) virtual 關鍵字用於在基類中修飾方法。virtual的使用會有兩種情況: 情況1:在基類中定義了virtual方法,但在派生類中沒有重寫該虛方法。那麼在對派生類實例的調用中,該虛方法使用的是基類定義的方法。 情況2:在基類中定義了vi ...
  • 2019年9月23——25日 .NET Core 3.0即將在.NET Conf上發佈! .NET Core的發佈及成熟重燃了.net程式員的熱情和希望,一些.net大咖也在積極的為推動.NET Core而不懈的努力。在這次.NET Core 3.0中一項新的技術也首次出現在人們的視野,這就是Bla ...
  • 背景描述 最近接到一個需求,就是要求我們的 WPF 客戶端具備本地化功能,實現中英文多語言界面。剛開始接到這個需求,其實我內心是拒絕的的,但是沒辦法,需求是永無止境的。所以只能想辦法解決這個問題。 首先有必要說一下我們的系統架構。我們的系統是基於 Prism 來進行設計的,所以每個業務模塊之間都是相 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...