XSLT 文件中使用 C#/JScript/VB 自定义函数

在用 XSLT 转换 XML 到其他格式时，不光是原数据搬到别处，还可能需要对数据进行一定的处理，比如一个标志位要 XSLT 转换为表义字符串(1->True; 0->False)，或者日期类型格式的转换等等。所以这时候我们在 XSLT 中要用到函数来处理这些细节上的转换。

XSLT 含有超过 100 个内建的函数，XQuery 1.0、XPath 2.0 以及 XSLT 2.0 共享相同的函数库。
这些函数用于字符串值、数值、日期和时间比较、节点和 QName 操作、序列操作、逻辑值，等等。

关于 XSLT 的内置函数请参数：XSLT 函数参考手册 和 XPath、XQuery 以及 XSLT 函数。

而我在这里介绍的是，如果你觉得内置函数用起来还有点麻烦的话，还可以用 C# 或 JavaScript 等语言在 XSLT  中定义自己的函数，使用方便的数据类型、语法让你更娴熟的完成数据的转换。

比如，一个比较实际的应用，要用 XSLT 从某个 rss 内容中获得标题和发布日期显示在 Html Table 中，需要把 <pubDate>Wed, 09 Jun 2010 02:52:00 GMT</pubDate> 日期显示格式显示为 Jun 01, 2010 这样的形式。

从 http://www.blogjava.net/Unmi/rss 抽取出的一个 <item> 节点片段如下：

<rss>
    <channel>
        <item>
           <title>写第一个 WordPress 插件程序</title>
           <link>http://www.blogjava.net/Unmi/archive/2010/04/27/319398.html</link>
           <dc:creator>隔叶黄莺</dc:creator>
           <author>隔叶黄莺</author>
           <pubDate>Mon, 26 Apr 2010 17:06:00 GMT</pubDate>
           ..............................................
        </item>
          ...............................................

我们可以写这么一个 XSLT 文件，假如保存为 c:\\Unmi_Rss_List.xslt，内容如下：

这里说明一点，函数必须为 public 的，否则会提示： Method 'FormatDate' of extension object 'http://www.detabis.com/busrules' cannot be called because it is not public.在 FormatDate 中可以使用你能在 C# 中的任何东西。

xmlns:unmi="http://unmi.blogjava.net" 定义了一个前缀 unmi 而已，也就是命名空间，没有什么特别的意义，可随你所愿用别的前缀，但必须与其他用到这个前缀的地方保持一致。如果不定义这么一个命名空间的话，直接不带前缀的调用 FormatDate() 函数时，默认为的命名空间是 fn，而 fn 中是不存这个函数的。

执行转换的代码这里放在一个 aspx 页面的后端文件中的，这样你直接浏览这个页面就会显示在网页上。你也可以让转换出的结果存成文件或输出在屏幕上。Test_Xslt.aspx.cs 中的代码如下：

说明：XslCompiledTransform.Load()  时，必须设置 XsltSettings 中的第二个参数 enable script 为 true。
Transform(string inputUri, XmlWriter results)，第一个参数可以为一个网页的 URL，第二个参数直接借助于 Response，输出到页面。
Transform() 有许多重载的方法，可输出内容到流、文件，还可以传入 XSLT 要求的参数(<xsl:param name="param1"/>)

浏览网页 Test_Xslt.aspx 得到的效果是：

当然，上面的 XSLT 中用 C# 来定义函数，执行时肯定要依赖于 .Net 环境的，如果是 .Net 环境下的应用不失为一种好办法。其他运行环境下要定义自己的 XSLT 函数就得想别的办法了，比如用 JavaScript 来定义函数。应该说见到 <msxsl:script> 它大概就是个 MS Only 的东西。关于 Java 应用 XSLT 时，用 Java 定义  XSLT 函数请参考：用Java增加一个XSLT功能。

从 XSLT Stylesheet Scripting using <msxsl:script> 可以看到定义函数的 language 可选值有：C#, VB, JScript, JavaScript, VisualBasic, CSharp，如果未指定该属性，默认为 JScript。也就是说你可以用以上的语言(也就是 C#、VB、JScript/JavaScript，通常 JScript 和 JavaScript 被认为是一样的)来自定义函数，这个链接里也说明了默认导入的命名空间。

因此，在标题中标示了可用三种语言来自定义函数，只需用 C# 来说明用法，其他语言只语法不同而已，读者一望便知。

参考：

• XSLT Stylesheet Scripting using <msxsl:script>
• 用C#或JavaScript扩展XSLT
• xslt自定义函数
• 用Java增加一个XSLT功能(用 Apache Xalan XSL 时，如何用 Java 自定义 XSLT 函数)