萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

XSLT 樣式表參數傳遞完整教學:伺服器端與用戶端雙重實作

應用場景

同一份 XSLT 樣式表需套用多份 XML 資料,僅頂部標題、頁首資訊等小部分不同。透過 xsl:param 定義參數,呼叫端動態傳入值,實現「一表多用」。

XSLT 定義參數

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0"
    xmlns:xsl="https://www.w3.org/1999/XSL/Transform"
    xmlns:msxsl="urn:schemas-microsoft-com:xslt"
    exclude-result-prefixes="msxsl">

  <xsl:output method="xml" indent="yes"/>

  <!-- 定義參數,預設值為空字串 -->
  <xsl:param name="Title" select="''"/>

  <xsl:template match="/">
    <html>
      <head></head>
      <body>
        <h1><xsl:value-of select="$Title"/></h1>
        <!-- 其他共用轉換邏輯 -->
      </body>
    </html>
  </xsl:template>
</xsl:stylesheet>
  • xsl:param 為全域參數,select 屬性給預設值(XPath 運算式)。
  • 模板內使用 $Title 參考參數值。
  • 可定義多個參數:<xsl:param name="Author" select="''"/>。

.NET 用戶端傳遞參數

using System;
using System.Xml;
using System.Xml.Xsl;
using System.Xml.XPath;
using System.IO;

class Program {
    static void Main() {
        // 1. 載入 XML 資料
        var doc = new XmlDocument();
        doc.LoadXml("<Tables><Table><Name>Orders</Name></Table></Tables>");

        // 2. 載入並編譯 XSLT
        var transform = new XslCompiledTransform();
        transform.Load("Test.xslt");

        // 3. 建立參數清單並加入值
        var args = new XsltArgumentList();
        args.AddParam("Title", "", "陳希章的報告");  // (名稱, 命名空間, 值)

        // 4. 執行轉換並輸出
        using (var fs = new FileStream("Test.htm", FileMode.Create)) {
            transform.Transform(doc.CreateNavigator(), args, fs);
        }
        Console.WriteLine("轉換完成:Test.htm");
    }
}

關鍵類別說明

類別用途
XslCompiledTransformXSLT 2.0 相容處理器,效能優於舊版 XslTransform
XsltArgumentList參數容器,AddParam(name, ns, value) 加入參數
XPathNavigator提供唯讀、游標式 XML 導航,XmlDocument.CreateNavigator() 取得
XmlWriter / Stream輸出目標,此處用 FileStream 寫入檔案

進階用法

傳遞複雜型別(節點集、物件)

// 傳遞 XML 片段
var frag = doc.CreateDocumentFragment();
frag.InnerXml = "<Items><Item ID='1'/><Item ID='2'/></Items>";
args.AddParam("ItemList", "", frag);  // XSLT 中用 $ItemList/Item 存取

// 傳遞擴充物件 (Extension Object)
args.AddExtensionObject("urn:my-ext", new MyHelperClass());
' XSLT: xmlns:my="urn:my-ext" → my:FormatDate($date)

ASP.NET 網頁中使用

protected void Page_Load(object sender, EventArgs e) {
    var xslt = new XslCompiledTransform();
    xslt.Load(Server.MapPath("~/Styles/Report.xslt"));

    var args = new XsltArgumentList();
    args.AddParam("ReportTitle", "", "月銷售報表 - " & DateTime.Now.ToString("yyyy-MM"));
    args.AddParam("UserName", "", User.Identity.Name);

    Response.ContentType = "text/html";
    xslt.Transform(Server.MapPath("~/Data/Report.xml"), args, Response.Output);
}

參數驗證與預設值策略

  • XSLT 端:<xsl:param name="Title" select="'預設標題'"/> 給予合理預設,避免參數遺漏導致輸出異常。
  • 用戶端:檢查必要參數是否已 AddParam,缺失時拋出明確例外。

效能優化建議

  1. 快取 XslCompiledTransform:實例化成本高,建議單例或靜態快取。
  2. 預編譯:transform.Load() 會編譯為 IL,重複使用極快。
  3. 避免文件碎片:大量轉換時重用 XmlWriterSettings、StringWriter 等。

掌握 XSLT 參數機制,即可構建靈活、可維護的 XML 轉換管線,廣泛應用於報表產生、文件發佈、多語系輸出等場景。

copyright © 萬盛學電腦網 all rights reserved