TagHelper的一些个人学习体会（发现了微软官方文档的一个错误）

最近一直在学习.net core 上周六开始学习Taghelper的自定义，准备周日写个博客和大家分享一下学习体会，无奈周日去考科四了，回来之后就感冒了，现在还没好。可是我发现了微软官方文档的一个错误，觉得立马要和大家分享出来，免得后边的人和我走一样的弯路

首先这是微软官网关于TagHelper的自定义使用说明链接https://docs.microsoft.com/en-us/aspnet/core/mvc/views/tag-helpers/authoring 无奈我的英语水平不太好，勉强还能看懂。

在这一章  Passing a model to a Tag Helper 的说明中

　　　　首先声明了Models 文件夹下声明一个类

   public class WebsiteContext
     {
         public Version Version { get; set; }
         public int CopyrightYear { get; set; }
         public bool Approved { get; set; }
         public int TagsToShow { get; set; }
     }

　　　　接下来他的自定义TagHelper要使用这个类

   public class WebsiteInformationTagHelper : TagHelper
     {
         public WebsiteContext 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>Approved:</strong> {Info.Approved}</li>
 <li><strong>Number of tags to show:</strong> {Info.TagsToShow}</li></ul>");
          output.TagMode = TagMode.StartTagAndEndTag;
       }
    }

　　　　在接下来在前台他要是用这个TagHelper

 @using AuthoringTagHelpers.Models
 @{
     ViewData["Title"] = "About";
 }
 <h2>@ViewData["Title"].</h2>
 <h3>@ViewData["Message"]</h3>

 <p bold>Use this area to provide additional information.</p>

 <bold> Is this bold?</bold>

 <h3> web site info </h3>
 <website-information info="new WebsiteContext {
                                     Version = , ),
                                     CopyrightYear = ,
                                     Approved = true,
                                     TagsToShow =  }" />

　　　这个就是他的使用过程

如果 按照他的说明这样做完之后你会发现根本不行，浏览器报错  错误很明显 无法将Version类型转化为String类型

好了这里改一下

<Website-Information info="new WebSiteContext {

                                  Version = new string('1', 3),
                                    CopyrightYear = ,
                                    Approved = true,
                                    TagsToShow =  }" ></Website-Information>

这会测试的时候改完之后就可以直接运行了。原来在改之前还会出现一个错误。  <Website-Information info="......"></Website-Information>会报出无法识别 info这个属性， 给大家分析一下 首先Website-Information这个Tag是原本都没有的，是我们自己定义的。所以它本身也就不存在什么属性，而这里直接使用它的info属性。它肯定无法识别，所以在这里我们需要对其自定义的时候加上这个属性，让编译器能够识别 。

public class WebsiteInfomationTagHelper : TagHelper
    {
        public WebSiteContext Info { get; set; }
        public override void Process(TagHelperContext context, TagHelperOutput output)
        {

            output.TagName = "section";
            //如果说添加的属性不存在用add方法
            output.Attributes.Add("info", Info);
            //添加的属性存在则用setAttribute方法
            //output.Attributes.SetAttribute("info", info);
            output.Content.SetHtmlContent(
                $@"<ul><li><strong>Version:</strong> {Info.Version}</li>
<li><strong>Copyright Year:</strong> {Info.CopyrightYear}</li>
<li><strong>Approved:</strong> {Info.Approved}</li>
<li><strong>Number of tags to show:</strong> {Info.TagsToShow}</li></ul>"
                );
            output.TagMode=TagMode.StartTagAndEndTag;

        }
    }

　　　　这样进行一番修改之后就可以运行了 这是运行的结果

　　　　可能本人才疏学浅。毕竟刚开始学没两天。有什么问题欢迎在评论区评论。我会第一时间进行回复。希望大家一起帮助一起成长。