自打Netcore推出以来，很多人是紧追不舍，关注度颇高，一时间让它成为了asp.net中的一等公民。我也是其中一份子，顶多算是一个伪粉丝吧，因为关注不太多，不够深。
今天，主要记录的学习笔记是：如何自定义自己的Taghelper。话不多说，直入正题：
1、定义接口
public interface ICountryService
{
IEnumerable<CountryModel> GetAll();
}
2、定义接口实现类
public class CountryService : ICountryService
{
private static IEnumerable<CountryModel> CountryList = new List<CountryModel>()
{
new CountryModel() { Id=1,enName="China",CnName="中国",Code="China"},
new CountryModel() { Id=2,enName="Japan",CnName="日本",Code="Japan"},
new CountryModel() { Id=3,enName="America",CnName="美国",Code="America"},
};
public IEnumerable<CountryModel> GetAll()
{
return CountryList;
}
}
3、注入
对于注入，多说几句。在.net core中，有几种常见注入方式：分别为（个人理解，不对的请大牛斧正）：
AddTransient: 每次请求ICountryService，就会生成一个对象;
AddSingleton: 顾名思义，单例模式；贯穿整个application的生命周期，从Start--->End;
AddScoped:可以理解为贯穿当前请求的整个生命周期。怎么理解呢，就是说当你第一次请求ICountryService的一个对象；在该请求的另外一个环节中，如果用到了ICountryService的其他逻辑，那么同样会共用第一次生成的对象。直到此次请求的生命周期结束。我个人认为，相当于生命周期内部的单例模式；
public void ConfigureServices(IServiceCollection services)
{
// the others
services.AddTransient<ICountryService, CountryService>();
}
4、自定义自己的Taghelper方法
// 自定义Taghelper类，主要的是要继承TagHelper，位于命名空间Microsoft.AspNetCore.Razor.TagHelpers下
public class CountryListTagHelper : TagHelper
{
private readonly ICountryService _countryService;
public string SelectedValue { get; set; } // 自定义的属性，在后续中会用到
public CountryListTagHelper(ICountryService countryService)
{
_countryService = countryService;
}
public override void Process(TagHelperContext context, TagHelperOutput output)
{
output.TagName = "select";
output.Content.Clear();
foreach (var item in _countryService.GetAll())
{
var seleted = "";
if (SelectedValue != null && SelectedValue.Equals(item.Code, StringComparison.CurrentCultureIgnoreCase))
{
seleted = " selected=\"selected\"";
}
var listItem = $"<option value=\"{item.Code}\"{seleted}>{item.CnName}-{item.enName}</option>";
output.Content.AppendHtml(listItem);
}
//base.Process(context, output);
}
}
因为需要继承TagHelper，所以需要引入以下依赖包（如果用VS2015工具开发，会提示会让你安装什么什么依赖的）：
"Microsoft.AspNetCore.Razor.Runtime": "1.0.0", "Microsoft.AspNetCore.Mvc.TagHelpers": "1.0.0" 其实，这里只是使用到了同步方法，还有一个异步方法，具体定义和描述如下：
namespace Microsoft.AspNetCore.Razor.TagHelpers
{
/// <summary>Class used to filter matching HTML elements.</summary>
public abstract class TagHelper : ITagHelper
{
protected TagHelper();
/// <inheritdoc />
public virtual void Init(TagHelperContext context);
/// <summary>
/// Synchronously executes the <see cref="T:Microsoft.AspNetCore.Razor.TagHelpers.TagHelper" /> with the given <paramref name="context" /> and
/// <paramref name="output" />.
/// </summary>
/// <param name="context">Contains information associated with the current HTML tag.</param>
/// <param name="output">A stateful HTML element used to generate an HTML tag.</param>
public virtual void Process(TagHelperContext context, TagHelperOutput output);
/// <summary>
/// Asynchronously executes the <see cref="T:Microsoft.AspNetCore.Razor.TagHelpers.TagHelper" /> with the given <paramref name="context" /> and
/// <paramref name="output" />.
/// </summary>
/// <param name="context">Contains information associated with the current HTML tag.</param>
/// <param name="output">A stateful HTML element used to generate an HTML tag.</param>
/// <returns>A <see cref="T:System.Threading.Tasks.Task" /> that on completion updates the <paramref name="output" />.</returns>
/// <remarks>By default this calls into <see cref="M:Microsoft.AspNetCore.Razor.TagHelpers.TagHelper.Process(Microsoft.AspNetCore.Razor.TagHelpers.TagHelperContext,Microsoft.AspNetCore.Razor.TagHelpers.TagHelperOutput)" />.</remarks>
/// .
public virtual Task ProcessAsync(TagHelperContext context, TagHelperOutput output);
/// <inheritdoc />
/// <remarks>Default order is <c>0</c>.</remarks>
public virtual int Order { get; }
}
}
轮子到此就算是造好了，那就需要要检测一下是否能跑吧。
5、应用检测
我这里就把这个引用放到了单个view页面中了，（以下三种方式，任选其一即可）
// 格式：@addTagHelper typeName,AssemblyName
// 方式一，程序集下所有的Taghelper @addTagHelper *,TodoList.Project // 方式二，明确指定路径 @addTagHelper "TodoList.Project.Extensions.CountryListTagHelper,TodoList.Project" // 方式三，模糊匹配 @addTagHelper "TodoList.Project.Extensions.CountryList*,TodoList.Project"
标签引入方式为：
<country-list selected-value="China"></country-list>
效果图如下：
生成的html代码为：
<select><option value="China" selected="selected">中国-China</option><option value="Japan">日本-Japan</option><option value="America">美国-America</option></select>
其实这里涉及到了两个地方，一个是创建项目时，自带的_ViewImports.cshtml，这个文件是干嘛的呢？个人理解是view中需要导入的一些命名空间之类的。而且是全局使用的。
如果你要是单独一个view使用，那么就在对应的view页面中增加即可。
对于标签的命名规则：
大概是：如果有多个大写字母组成的（比如CountryList），那么会把大写全部转换为小写，然后分割单词（比如：CountryList--->country-list）;
如果是单个单词，则直接转小写；（比如EmailTagHelper ---> email）;
如果，你想自己指定html标签属性，可以在TagHelper上增加一个属性标签：
[HtmlTargetElement("country-lists")]
public class CountryListTagHelper : TagHelper
使用的时候，就是<country-lists selected-value="China"></country-lists>
6、后记
主要是有一些疑问，我大概翻了一下源码，也没找到对于自定义的Taghelper，在前面页面中使用的命名规则是什么样子的。就断断续续看到过一些备注上的示例。这让我有点不爽。（谁找到了，麻烦告诉一下在哪里）
其实，也有一些自带的Taghelper，比如：
参考资料：
https://docs.asp.net/en/latest/mvc/views/tag-helpers/intro.html
http://www.cnblogs.com/TomXu/p/4496480.html