同一份 XSLT 樣式表需套用多份 XML 資料,僅頂部標題、頁首資訊等小部分不同。透過 xsl:param 定義參數,呼叫端動態傳入值,實現「一表多用」。
<?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="''"/>。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");
}
}
| 類別 | 用途 |
|---|---|
XslCompiledTransform | XSLT 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)
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);
}
<xsl:param name="Title" select="'預設標題'"/> 給予合理預設,避免參數遺漏導致輸出異常。AddParam,缺失時拋出明確例外。transform.Load() 會編譯為 IL,重複使用極快。XmlWriterSettings、StringWriter 等。掌握 XSLT 參數機制,即可構建靈活、可維護的 XML 轉換管線,廣泛應用於報表產生、文件發佈、多語系輸出等場景。