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# 定义的函数 Jun 13, 2010
VS 2008中的jQuery Intellisense[转] Jun 09, 2010
使用 NAnt 构建 asp.net 项目并生成一个固定名字的动态库 Jun 06, 2010
C# 使用 iTextSharp(5.0.2) 生成 PDF 文档 May 22, 2010
C# 使用 iTextSharp(4.1.2) 生成 PDF 文档 May 22, 2010
C# 使用 ExcelLibrary 读写 Excel 文件 May 20, 2010
掌握一种 C#/.Net 模板技术 -- Velocity May 19, 2010
VS2008 发布网站时如何产生固定命名的 Dll 文件 May 14, 2010
Asp.Net 中一个控件关联多个验证器时,如何同时只出一个验证器的错误信息 May 14, 2010
C# 程序中使用 SQLite 数据库 May 06, 2010
PHP 异步执行方法,模拟多线程 Apr 29, 2010
打造自己的WordPress侧边栏[转] Apr 28, 2010
写第一个 WordPress 插件程序 Apr 27, 2010
雅虎JavaScript架构师:网页开发技术安全优先 Apr 26, 2010
那些相见恨晚的 JavaScript 技巧 Apr 26, 2010

当然,上面的 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# 来说明用法,其他语言只语法不同而已,读者一望便知。

参考:1. XSLT Stylesheet Scripting using <msxsl:script>
        2. 用C#或JavaScript扩展XSLT
        3. xslt自定义函数
        4. 用Java增加一个XSLT功能(用 Apache Xalan XSL 时,如何用 Java 自定义 XSLT 函数)

类别: XML/DOM. 标签: , , , . 阅读(590). 订阅评论. TrackBack.

Leave a Reply

Be the First to Comment!

avatar
wpDiscuz