在ASP.NET MVC 中使用Jntemplate
上一篇我們詳細介紹了jntemplate的標籤語法，本篇文章將繼續介紹如何在ASP.NET MVC 中使用Jntemplate。
一、使用Jntemplate
- 首先我們先新建一個
asp.net mvc專案，開啟VS2019，依次點選檔案-新建-專案，選擇ASP.NET CoreWeb應用(模型-檢視-控制器)，然後依次下一步，建立一個web應用。
- 點選
專案-管理NUGET程式包，點選瀏覽,輸入jntemplate,安裝好包JinianNet.JNTemplate.
- 開啟
HomeController.cs新增如下程式碼
public VariableScope Data { get; set; } = new VariableScope(null);
public IActionResult Jntemplate(string path)
{
var t = Engine.LoadTemplate(path);
t.Context.TempData = this.Data;
var result = t.Render();
return Content(result, "text/html");
}
- Index Action我們也要稍微改造一樣，開啟
IndexAction，改造如下：
public IActionResult Index()
{
this.Data.Set("Name", "Jntemplate");
this.Data.Set("Now", DateTime.Now);
return Jntemplate("Views/Home/Index.html");
}
- 新建一個檢視檔案
Index.html，原來的Index.cshtml直接刪除，並編輯內容如下：
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>${Name} web 應用</title>
</head>
<body>
<h1>Welcome to ${Name}!</h1>
<p>©${Now.Year}</p>
</body>
</html>
- 最後別忘記在
Startup配置一下引擎工作目錄，開啟Startup，在Configure中新增一句：Engine.Configure(c=>c.ResourceDirectories.Add(env.ContentRootPath));
- 好了，我們的jntemplate web應用已經完成了，按
F5，執行看一下次果吧。
小提示：為了方便使用，我們可以新建一個控制器基類，將第3步的程式碼移到基類中。
二、使用JntemplateViewEngine
在上面我們雖然實現了jntemplate的使用，但是步驟相對繁瑣，我們可以直接使用Jntemplate檢視引擎來簡化使用.
安裝
首先新建一個asp.net mvc專案（參見上面的步驟）。然後我們先新增JntemplateViewEngine包， 點選專案 - 管理NUGET程式包，點選瀏覽,輸入Jntemplate,安裝好包JinianNet.AspNetCoreViewEngine.Jntemplate.
配置
- 開啟
Startup在ConfigureServices方法中增加AddJntemplateViewEngine:
public void ConfigureServices(IServiceCollection services)
{
//原來的程式碼
services.AddJntemplateViewEngine();
}
如果你的檢視檔案按照預設習慣放在Views目錄下，直接照上面的程式碼配置就可以了，如果是放在其它目錄，則需要把目錄新增到配置裡面。
public void ConfigureServices(IServiceCollection services)
{
//原來的程式碼
services.AddJntemplateViewEngine((o) => {
o.ViewLocationFormats.Add("/template/{1}/{0}.html");
});
}
{0}為檢視名，{1}為控制器名。
- 在
Configure方法中增加UseJntemplate,如下如示
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
//原來的程式碼
//Use Jntemplate
app.UseJntemplate(c =>
{
//在這裡你也可以進行其它引數的配置，比如全域性資料
//這一句很重要，不然會找不到檢視
c.ContentRootPath = env.ContentRootPath;
});
}
新增Action
開啟HomeController.cs ，新增一個Index檢視方法（或修改對應檢視方法）如下：
例：
public IActionResult Index()
{
this.Set("Name", "Jntemplate");
this.Set("Now", DateTime.Now);
return View();
}
新增檢視Index.html
在Views\Home目錄新建一個檢視檔案Index.html，內容如下（與第一節的一致）：
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>${Name} web 應用</title>
</head>
<body>
<h1>Welcome to ${Name}!</h1>
<p>©${Now.Year}</p>
</body>
</html>
執行
按F5執行檢視效果。
三、總結
本文介紹了在asp.net mvc中如何使用jntemplate，其它MVC框架、開發框架，使用方法類似。至本篇為止，.net 開源模板引擎jntemplate 教程的基礎篇已經全部寫完，在接下來的時間我將繼續介紹jntemplate的進階用法（.net 開源模板引擎jntemplate 教程之進階篇）：包括自定義配置，預編譯檔案，自定義載入器，自定義標籤等內容，感興趣的朋友不要錯過 。
目錄：
- .net 開源模板引擎jntemplate 教程：基礎篇之入門
- .net 開源模板引擎jntemplate 教程：基礎篇之語法
- .net 開源模板引擎jntemplate 教程：基礎篇之在ASP.NET MVC中使用Jntemplate