萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> .NET 程式設計

ASP.NET 簡易模板引擎實作:靜態 HTML 模板 + 字串取代生成靜態頁

什麼是模板引擎?

模板引擎的核心思想:預先設計靜態 HTML 模板(含佔位符),程式讀取模板、替換佔位符為動態資料,輸出最終靜態頁面。優點:邏輯與表現分離、前端易維護、減少伺服器端渲染壓力。

架構圖解

  1. 前端頁面(Default.aspx):輸入標題、內容、目標 URL
  2. 模板檔(template.htm):含 $title$、$content$ 等標記
  3. 後端程式:讀取模板 → 字串替換 → 寫入靜態 .htm 檔

模板檔範例 (template.htm)

<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
  <title> $title$ 生成靜態頁</title>
  <style> .STYLE1 { font-size:16px; font-weight:bold; } </style>
</head>
<body>
  <table width="100%" border="0" bgcolor="#339900">
    <tr><td height="34" align="center" bgcolor="#FFFFFF"><span class="STYLE1">$title$</span></td></tr>
    <tr><td height="42" bgcolor="#FFFFFF"><br/>內容:$content$</td></tr>
  </table>
</body>
</html>

後端核心邏輯 (Default.aspx.cs)

using System; using System.IO; using System.Text; using System.Web;

namespace ToHtml {
    public partial class _Default : System.Web.UI.Page {
        protected void Button1_Click(object sender, EventArgs e) {
            // 1. 讀取模板
            string mbPath = Server.MapPath("template.htm");
            Encoding code = Encoding.GetEncoding("gb2312");
            string template;
            using (var sr = new StreamReader(mbPath, code)) {
                template = sr.ReadToEnd();
            }

            // 2. 替換標記
            template = template.Replace("$title$", txtTitle.Text);
            template = template.Replace("$content$", txtContent.Text);

            // 3. 產生檔名 (時間戳避免衝突)
            string fileName = DateTime.Now.ToString("yyyyMMddHHmmss") + ".htm";

            // 4. 寫入靜態檔
            string savePath = Server.MapPath("htm/") + fileName;
            using (var sw = new StreamWriter(savePath, false, code)) {
                sw.Write(template);
            }
            Response.Write("恭喜 " + fileName + " 已生成,保存在 htm 資料夾!");
        }

        protected void Button2_Click(object sender, EventArgs e) {
            // 依 URL 抓取遠端頁面並存為靜態檔
            Encoding code = Encoding.GetEncoding("utf-8");
            string url = txtUrl.Text.Trim();
            string html;
            using (var resp = WebRequest.Create(url).GetResponse())
            using (var sr = new StreamReader(resp.GetResponseStream(), code)) {
                html = sr.ReadToEnd();
            }
            string fileName = DateTime.Now.ToString("yyyyMMddHHmmss") + ".html";
            using (var sw = new StreamWriter(Server.MapPath("htm/") + fileName, false, code)) {
                sw.Write(html);
            }
            Response.Write("恭喜 " + fileName + " 已生成!");
        }
    }
}

關鍵技術點

  • StreamReader/StreamWriter 指定編碼(範例用 gb2312/utf-8)
  • Server.MapPath 解析虛擬路徑為實體路徑
  • String.Replace 簡單粗暴但高效的標記替換
  • 時間戳檔名避免衝突,實際專案建議加入 GUID 或流水號
  • 目錄 htm/ 需具備寫入權限

擴展方向

  • 支援迴圈標記(如 <!-- Loop:Articles -->...<!-- /Loop -->)生成列表
  • 引入 NVelocity、RazorEngine、Scriban 等成熟模板引擎
  • 結合輸出快取、CDN 發佈實現真正靜態化站群

此範例雖簡陋,卻完整展示「模板→資料→靜態頁」的核心流程,是理解靜態站點生成器(如 Jekyll、Hexo)原理的最佳入門教材。

copyright © 萬盛學電腦網 all rights reserved