详解ASP.NET MVC 解析模板生成静态页（RazorEngine）

网络编程 2021-07-04 22:41www.168986.cn编程入门

我们在很多项目开发中会常常用到页面静态化，本篇文章主要介绍了详解ASP.NET MVC 解析模板生成静态页（RazorEngine），具有一定的参考价值，有兴趣的可以了解一下。

简述

Razor是ASP.NET MVC 3中新加入的技术，以作为ASPX引擎的一个新的替代项。在早期的MVC版本中默认使用的是ASPX模板引擎，Razor在语法上的确不错，用起来非常方便，简洁的语法与.NET Framework 结合，广泛应用于ASP.NET MVC 项目。

我们在很多项目开发中会常常用到页面静态化，页面静态化有许多方式，最常见的就是类似很多PHP CMS种使用的标签替换的方式（如帝国CMS、EcShop等），还有很多都是伪静态，伪静态我们就不做过多解释，通过路由或Url重写来实现就可以了。Razor为我们提供了更加方便的模板解析方式，任何东西都是两方面的，技术也是如此，Razor解析模板虽然更加方便、简洁，对于模板制作人员来说也是有一定的技术要求，或者对于开发一套模板制作功能来说，考虑的要更多一些。我们不再去探究这些问题，我们更注重哪种技术更容易、更方便、更好的满足我们项目的需求。

如何使用RazorEngine

今天来简单介绍一下如何使用RazorEngine解析模板生成静态页面，RazorEngine它是基于微软的Razor之上，包装而成的一个可以独立使用的模板引擎。也就是说，保留了Razor的模板功能，使得Razor脱离于Asp. MVC，能够在其它应用环境下使用，项目地址

我们去codeplex上下两个需要的dll

看到网上很多介绍RazorEngine的基础用法的，讲解的都比较详细，对于RazorEngine运行原理很清晰，我们在这里就不重复介绍了。写这篇文章是对于很多新手同学来说比较喜欢“拿来主义”，基本的用法原理都能看懂，如何应用到项目中还是有些不是很清晰，我们只讲讲如何在项目中运用。

本文分为两部分第一个部分，基本的单数据模型模板解析；第二部分，面向接口的多数据模型模板解析

第一个部分基本的单数据模型模板解析

一、我们创建一个MVC项目，并且添加上面的两个DLL引用，然后我们新建一个简单的文章类

public class Articles
  {
    /// <summary>
    /// 文章ID
    /// </summary>
    public int Id { get; set; }
    /// <summary>
    /// 文章标题
    /// </summary>
    public string Title { get; set; }
    /// <summary>
    /// 文章内容
    /// </summary>
    public string Content { get; set; }
    /// <summary>
    /// 作者
    /// </summary>
    public string Author { get; set; }
    /// <summary>
    /// 发布时间
    /// </summary>
    public DateTime CreateDate { get; set; }
  }

二、我们新建一个Razor的Html模板

<!DOCTYPE html>
<html xmlns="http://.w3./1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  <title>@Model.Title</title>
</head>
<body>
  <h1>@Model.Title</h1>
  <p>作者@Model.Author - 发布时间@Model.CreateDate</p>
  <p>@Raw(Model.Content)</p>
</body>
</html>

说明Model就是我们的文章实体类在MVC的试图页cshtml中我们一般都是在控制器里传递这个实体类然后在视图页中 @model Models.Articles 来接收这个实体类然后通过“@Model.”来输出内容，在Razor模板中是一样的，只是不用@model Models.Articles 来接收了，其它的语法跟在.cshtml试图页中是一样的，这么说多余了，因为写法不一样他就不是Razor了

三、我们写一个方法来获取模板页的Html代码

 /// <summary>
    /// 获取页面的Html代码
    /// </summary>
    /// <param name="url">模板页面路径</param>
    /// <param name="encoding">页面编码</param>
    /// <returns></returns>
    public string GetHtml(string url, System.Text.Encoding encoding)
    {
      byte[] buf = new WebClient().DownloadData(url);
      if (encoding != null) return encoding.GetString(buf);
      string html = System.Text.Encoding.UTF8.GetString(buf);
      encoding = GetEncoding(html);
      if (encoding == null || encoding == System.Text.Encoding.UTF8) return html;
      return encoding.GetString(buf);
    }

    /// <summary>
    /// 获取页面的编码
    /// </summary>
    /// <param name="html">Html源码</param>
    /// <returns></returns>
    public System.Text.Encoding GetEncoding(string html)
    {
      string pattern = @"(?i)\bcharset=(?<charset>[-a-zA-Z_0-9]+)";
      string charset = Regex.Match(html, pattern).Groups["charset"].Value;
      try { return System.Text.Encoding.GetEncoding(charset); }
      catch (ArgumentException) { return null; }
    }

四、我们写一个方法用于生成Html静态页

 /// <summary>
    /// 创建静态文件
    /// </summary>
    /// <param name="result">Html代码</param>
    /// <param name="createpath">生成路径</param>
    /// <returns></returns>
    public bool CreateFileHtmlByTemp(string result, string createpath)
    {
      if (!string.IsNullOrEmpty(result))
      {
        if (string.IsNullOrEmpty(createpath))
        {
          createpath = "/default.html";
        }
        string filepath = createpath.Substring(createpath.LastIndexOf(@"\"));
        createpath = createpath.Substring(0, createpath.LastIndexOf(@"\"));
        if (!Directory.Exists(createpath))
        {
          Directory.CreateDirectory(createpath);
        }
        createpath = createpath + filepath;
        try
        {
          FileStream fs2 = new FileStream(createpath, FileMode.Create);
          StreamWriter sw = new StreamWriter(fs2, new System.Text.UTF8Encoding(false));//去除UTF-8 BOM
          sw.Write(result);
          sw.Close();
          fs2.Close();
          fs2.Dispose();
          return true;
        }
        catch { return false; }
      }
      return false;
    }

五、我们来写个方法调用静态模板，并且传递数据模型实体类创建Html静态页

/// <summary>
    /// 解析模板生成静态页
    /// </summary>
    /// <param name="temppath">模板地址</param>
    /// <param name="path">静态页地址</param>
    /// <param name="t">数据模型</param>
    /// <returns></returns>
    public bool CreateStaticPage(string temppath, string path, RazorEngineTemplates.Models.Articles t)
    {
      try
      {
        //获取模板Html
        string TemplateContent = GetHtml(temppath, System.Text.Encoding.UTF8);

        //初始化结果
        string result = string.Empty;

        //解析模板生成静态页Html代码
        result = Razor.Parse(TemplateContent, t);

        //创建静态文件
        return CreateFileHtmlByTemp(result, path);
      }
      catch (Exception e)
      {
        throw e;
      }
    }

好了，大功告成，是不是很简单。

这里只是一个很简单的应用，没有读取数据，也没有列表，只有一个文章数据模型，下一部分我们将介绍多模型模板解析，因为是多模型所以生成静态页面的时候就不是传递一个具体模型实体类我们会用到反射，通过反射模型属性获取数据，有不熟悉反射的可以提前研究一下，也可以直接看下一部分的反射代码也很简单的。

第二部分面向接口的多数据模型模板解析

这一部分,我们介绍使用接口来解析模板，包括列表等多种模型解析，用到了Spring注入和反射还有接口等，有不熟悉的可以百度搜一下或者评论留言。

我们接着上面的示例，我们新建两个类库一个是存放数据模型的我们叫Domain；一个是接口和实现类的我们叫Service，然后我们添加他们之间的引用

一、我们在Domain下创建几个测试类

Articles - 文章测试类

Company - 公司测试类

Column - 栏目测试类

TemplateView - 模型解析类（这个是不是比较弱智？我也没深入研究多个模型怎么反射出来所以我加了这么个算是公用的类没有对应的数据表只是解析模板的时候作为中间件用用）

 　　public class Articles
  {
    /// <summary>
    /// 文章ID
    /// </summary>
    public int Id { get; set; }
    /// <summary>
    /// 文章标题
    /// </summary>
    public string Title { get; set; }
    /// <summary>
    /// 文章内容
    /// </summary>
    public string Content { get; set; }
    /// <summary>
    /// 作者
    /// </summary>
    public string Author { get; set; }
    /// <summary>
    /// 发布时间
    /// </summary>
    public DateTime CreateDate { get; set; }
  }
　　public class Company
  {
    /// <summary>
    /// 公司Id
    /// </summary>
    public int Id { get; set; }
    /// <summary>
    /// 公司名称
    /// </summary>
    public string CompanyName { get; set; }
    /// <summary>
    /// 公司电话
    /// </summary>
    public string CompanyTel { get; set; }
    /// <summary>
    /// 联系人
    /// </summary>
    public string ContectUser { get; set; }
    /// <summary>
    /// 创建时间
    /// </summary>
    public DateTime CreateDate { get; set; }
  }
 　　public class Column
  {
    /// <summary>
    /// 栏目ID
    /// </summary>
    public int Id { get; set; }
    /// <summary>
    /// 栏目名称
    /// </summary>
    public string Title { get; set; }
    /// <summary>
    /// 文章列表
    /// </summary>

    public virtual ICollection<Articles> Articles { get; set; }
  }
 　　public class TemplateView
  {
    /// <summary>
    /// ID
    /// </summary>
    public int Id { get; set; }
    /// <summary>
    /// 标题
    /// </summary>
    public string Title { get; set; }
    /// <summary>
    /// 内容
    /// </summary>
    public string Content { get; set; }
    /// <summary>
    /// 作者
    /// </summary>
    public string Author { get; set; }
    /// <summary>
    /// 时间
    /// </summary>
    public DateTime CreateDate { get; set; }    
    /// <summary>
    /// 公司名称
    /// </summary>
    public string CompanyName { get; set; }
    /// <summary>
    /// 公司电话
    /// </summary>
    public string CompanyTel { get; set; }
    /// <summary>
    /// 联系人
    /// </summary>
    public string ContectUser { get; set; }
    /// <summary>
    /// 文章列表
    /// </summary>
    public virtual ICollection<Articles> Articles { get; set; }
  }

二、我们在Service下创建一个基础操作接口以及其实现类（里面的很多方法比如获取页面的Html代码、获取页面的编码以及创建静态文件等是没有必要写在接口的这个可以写到公用的类库里，因为这里就用到这么几个方法所以我没有加公用类库就直接写在这里面了）

/// <summary>
  /// 基础操作接口
  /// </summary>
  /// <typeparam name="T"></typeparam>
  public interface IRepository<T> where T : class
  {
    /// <summary>
    /// 解析模板生成静态页
    /// </summary>
    /// <param name="temppath">模板地址</param>
    /// <param name="path">静态页地址</param>
    /// <param name="t">数据模型</param>
    /// <returns></returns>
    bool CreateStaticPage(string temppath, string path, T t);    

    /// <summary>
    /// 获取页面的Html代码
    /// </summary>
    /// <param name="url">模板页面路径</param>
    /// <param name="encoding">页面编码</param>
    /// <returns></returns>
    string GetHtml(string url, System.Text.Encoding encoding);

    /// <summary>
    /// 获取页面的编码
    /// </summary>
    /// <param name="html">Html源码</param>
    /// <returns></returns>
    System.Text.Encoding GetEncoding(string html);

    /// <summary>
    /// 创建静态文件
    /// </summary>
    /// <param name="result">Html代码</param>
    /// <param name="createpath">生成路径</param>
    /// <returns></returns>
    bool CreateFileHtmlByTemp(string result, string createpath);
  }
/// <summary>
  /// 基础接口实现类
  /// </summary>
  /// <typeparam name="T"></typeparam>
  public abstract class RepositoryBase<T> : IRepository<T> where T : class
  {
    /// <summary>
    /// 解析模板生成静态页
    /// </summary>
    /// <param name="temppath">模板地址</param>
    /// <param name="path">静态页地址</param>
    /// <param name="t">数据模型</param>
    /// <returns></returns>
    public bool CreateStaticPage(string temppath, string path, T t)
    {
      try
      {
        //实例化模型
        var Entity = new Domain.TemplateView();

        //获取模板Html
        string TemplateContent = GetHtml(temppath, System.Text.Encoding.UTF8);
        //初始化结果
        string result = "";

        //反射赋值
        Type typeT = t.GetType();
        Type typeEn = Entity.GetType();

        System.Reflection.PropertyInfo[] propertyinfosT = typeT.GetProperties();

        foreach (System.Reflection.PropertyInfo propertyinfoT in propertyinfosT)
        {
          System.Reflection.PropertyInfo propertyinfoEn = typeEn.GetProperty(propertyinfoT.Name);
          if (propertyinfoEn != null && propertyinfoT.GetValue(t, null) != null)
          {
            propertyinfoEn.SetValue(Entity, propertyinfoT.GetValue(t, null), null);
          }
        }

        //很多时候 我们并没有创建复杂的主外键关系 例如栏目下的文章 我们仅仅是在文章表中添加了一个所属栏目ID的字段
        //并没有创建关联 这种情况下 我们直接获取栏目的时候 是获取不到文章列表的
        //包括很多自定义的模型和字段 比如 文章的内容 可能不跟文章一个表 而是一个单独的大数据字段表 这种情况下 我们的
        //TemplateView.Content就需要单独获取一下另一个数据模型里的 这个文章的内容 这种时候 我们可以在这里重新给他赋值

        //如 传入的模型是 文章
        //if(t is Domain.Articles)
        //{
        //  Entity.Content= 查询大数据字段表中这篇文章的内容;
          
        /

上一篇：详解ASP.NET MVC 利用Razor引擎生成静态页下一篇：ASP.NET防止SQL注入的方法示例

详解ASP.NET MVC 解析模板生成静态页（RazorEngine）

狼蚁网络搜索

狼蚁网络导航

长沙seo优化

长沙网络营销

长沙网站建设

详解ASP.NET MVC 解析模板生成静态页（RazorEngine）

编程语言

狼蚁网络搜索

狼蚁网络导航

长沙seo优化

长沙网络营销

长沙网站建设