.net 開源模板引擎jntemplate 教程：基礎篇之在ASP.NET MVC中使用Jntemplate

時間 2021-04-11

標籤 html git github web mvc app 框架 asp.net this 欄目 ASP 简体版

原文原文鏈接

在`ASP.NET MVC` 中使用Jntemplate

上一篇咱們詳細介紹了jntemplate的標籤語法，本篇文章將繼續介紹如何在ASP.NET MVC 中使用Jntemplate。html

1、使用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咱們也要稍微改造同樣，打開Index Action，改造以下：

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>&copy;${Now.Year}</p>
</body>
</html>

最後別忘記在 Startup配置一下引擎工做目錄，打開Startup，在Configure中添加一句：Engine.Configure(c=>c.ResourceDirectories.Add(env.ContentRootPath));

好了，咱們的jntemplate web應用已經完成了，按F5，運行看一下次果吧。

小提示：爲了方便使用，咱們能夠新建一個控制器基類，將第3步的代碼移到基類中。git

2、使用JntemplateViewEngine

在上面咱們雖然實現了jntemplate的使用，可是步驟相對繁瑣，咱們能夠直接使用Jntemplate視圖引擎來簡化使用.github

安裝

首先新建一個asp.net mvc項目（參見上面的步驟）。而後咱們先添加JntemplateViewEngine包，點擊項目 - 管理NUGET程序包，點擊瀏覽,輸入Jntemplate,安裝好包JinianNet.AspNetCoreViewEngine.Jntemplate.web

配置

打開 Startup在ConfigureServices方法中增長AddJntemplateViewEngine:

public void ConfigureServices(IServiceCollection services)
{
    //原來的代碼
    services.AddJntemplateViewEngine();
}

若是你的視圖文件按照默認習慣放在Views目錄下，直接照上面的代碼配置就能夠了，若是是放在其它目錄，則須要把目錄添加到配置裏面。mvc

public void ConfigureServices(IServiceCollection services)
{
    //原來的代碼
    services.AddJntemplateViewEngine((o) => {
        o.ViewLocationFormats.Add("/template/{1}/{0}.html");
    });
}

{0}爲視圖名，{1}爲控制器名。app

在Configure方法中增長UseJntemplate,以下如示

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    //原來的代碼
    //Use Jntemplate
    app.UseJntemplate(c =>
    {
        //在這裏你也能夠進行其它參數的配置，好比全局數據
        //這一句很重要，否則會找不到視圖
        c.ContentRootPath = env.ContentRootPath;
    });
}

添加Action

打開HomeController.cs ，添加一個Index視圖方法（或修改對應視圖方法）以下：框架

例：asp.net

public IActionResult Index()
{
    this.Set("Name", "Jntemplate");
    this.Set("Now", DateTime.Now);
    return View();
}

添加視圖Index.html

在Views\Home目錄新建一個視圖文件Index.html，內容以下（與第一節的一致）：ui

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <title>${Name} web 應用</title>
</head>
<body>
    <h1>Welcome to ${Name}!</h1>
    <p>&copy;${Now.Year}</p>
</body>
</html>

運行

按F5運行查看效果。this

3、總結

本文介紹了在asp.net mvc中如何使用jntemplate，其它MVC框架、開發框架，使用方法相似。至本篇爲止，.net 開源模板引擎jntemplate 教程的基礎篇已經所有寫完，在接下來的時間我將繼續介紹jntemplate的進階用法（.net 開源模板引擎jntemplate 教程之進階篇）：包括自定義配置，預編譯文件，自定義加載器，自定義標籤等內容，感興趣的朋友不要錯過。