本文示範如何在 C# 中透過 XsltArgumentList,把外部參數傳進 XSLT 樣式表,讓同一份 XSL 能依傳入的參數動態決定輸出內容。
做法是先載入 XML 與 XSL,建立 XsltArgumentList 並用 AddParam 加入要傳遞的參數,最後在呼叫 Transform 時把這個參數清單一起傳入:
XmlDocument xmlDoc = new XmlDocument();
xmlDoc.Load(strFilePath);
XslTransform xslt = new XslTransform();
xslt.Load(strXslPath);
XsltArgumentList xslArg = new XsltArgumentList();
xslArg.AddParam("Key1", "", iXPath);
xslArg.AddParam("Path", "", strPath);
StringBuilder sb = new StringBuilder("");
StringWriter sw = new StringWriter(sb);
XmlTextWriter writer = new XmlTextWriter(sw);
xslt.Transform(xmlDoc, xslArg, writer, null);
writer.Close();
HXML.InnerHtml = sb.ToString();
對應的 XSL 檔用 <xsl:param> 宣告 Key1 與 Path 兩個參數,就能在樣式表中以 $Key1、$Path 取值使用:
<?xml version="1.0" encoding="UTF-8" ?>
<xsl:stylesheet xmlns:xsl="https://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:param name="Key1"/>
<xsl:param name="Path"/>
<xsl:template match="/">
<xsl:apply-templates select="/DB/L[@Key=$Key1]" />
</xsl:template>
<xsl:template match="L[@Type='1']">
<a target="_blank">
<xsl:attribute name="href"><xsl:value-of select="@Link" /></xsl:attribute>
<img border="0">
<xsl:attribute name="width"><xsl:value-of select="@width" /></xsl:attribute>
<xsl:attribute name="height"><xsl:value-of select="@height" /></xsl:attribute>
<xsl:attribute name="src"><xsl:value-of select="$Path" />Res/AD/<xsl:value-of select="@File" /></xsl:attribute>
</img>
</a>
</xsl:template>
<xsl:template match="L[@Type='2']">
<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
codebase="https://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,29,0">
<xsl:attribute name="width"><xsl:value-of select="@width" /></xsl:attribute>
<xsl:attribute name="height"><xsl:value-of select="@height" /></xsl:attribute>
<param name="movie"><xsl:attribute name="value"><xsl:value-of select="$Path" />Res/AD/<xsl:value-of select="@File" /></xsl:attribute></param>
<param name="quality" value="high"/>
<embed quality="high" pluginspage="https://www.macromedia.com/go/getflashplayer" type="application/x-shockwave-flash">
<xsl:attribute name="width"><xsl:value-of select="@width" /></xsl:attribute>
<xsl:attribute name="height"><xsl:value-of select="@height" /></xsl:attribute>
<xsl:attribute name="src"><xsl:value-of select="$Path" />Res/AD/<xsl:value-of select="@File" /></xsl:attribute>
</embed>
</object>
</xsl:template>
</xsl:stylesheet>
對應的 XML 檔則用 Type 屬性區分要套用哪個樣板(Type='1' 顯示圖片、Type='2' 顯示 Flash),並以 Key 屬性比對傳入的 Key1:
<?xml version="1.0" encoding="GB2312"?>
<DB>
<L Name="測試1" height="100" width="100" Link="https://www.123.com"
File="20056171345164340.gif" Key="200561713451653143405" Type="1" />
</DB>
這個技巧的價值在於「參數化」:把路徑(Path)、篩選條件(Key1)等經常變動的值從 XSL 中抽拔出來,改由程式在執行階段傳入,就能讓同一份樣式表在不同情境下重用,不必為每個變化的參數各寫一份 XSL。這在廣告輪播、依環境切換資源路徑等場景中特別實用。