VTemplate模板引擎的使用—Function标签

了解或者认识VTemplate:

VTemplate也被网友们简称VT,它是一个基于.net里的模板引擎。

http://www.cnblogs.com/kingthy/archive/2009/08/17/net-vtemplate.html

 

现在让我们了解一下VT里最常用的function标签。

 

Function标签

其定义格式:

<vt:function var="变量" method="方法名" type="类型或实例变量" args="参数" output="true/false" />

它的作用即是在VT里调用某个方法并将返回值赋给某个变量(定义了var的情况)。

 

假设我们现有这样的一个类定义

namespace Test
{
    public class Db
    {
        public DataTable GetData()
        {
            //这里是详细的代码
        }

        public DataTable GetDataByName(string name)
        {
            //这里详细的代码
        }

        public static DataTable GetDbData()
        {
            //这里是详细的代码
        }
    }
}

现在我们要调用其定义的方法。

 

静态方法的调用

在我们的程序代码里,如果要调用上面类的GetDbData静态方法,我们一般这样写(完整写法)

var data = Test.Db.GetDbData();

而将上面的语句转成VT的模板标签后,就需要写成这样的function标签

 

<vt:function var="data" method="GetDbData" type="Test.Db" />

 

也就是function标签里的type属性我们需要写Db类的完整定义路径。

 

实例方法的调用

在我们的程序代码里,如果要调用类实现的方法,我们一般这样写

var db = new Db();
var data = db.GetData();
 

而将上面代码转成VT的模板标签后,我们的function标签就是这样写

 

<vt:function var="data" method="GetData" type="$db" />
 

function标签里的type属性我们写为“$db”,这就表示,我们调用的方法是“db”这个变量的实例方法。

但这个变量是从哪里来呢?这个变量也是同程序代码里一样,也是需要你在VT里对其赋值,比如下面的示例代码:

TemplateDocument document = TemplateDocument.FromFileCache(@"c:\template\test.html", Encoding.UTF8);
            document.SetValue("db", new Db());

 

上面代码里我们调用了SetValue方法,将“db”这个变量赋值到了VT模板里,这样模板里就可以调用此变量的值或方法了。

 

带参数的方法调用

如上面Db类里的GetDataByName方法,在程序代码里我们一般这样写

var db = new Db();
            var data = db.GetDataByName("car");

 

而对于带参数的方法,在VT模板里,我们就可以使用function标签里的args属性,如下面

<vt:function var="data" method="GetDataByName" type="$db" args="car" />

 

而如果我们的参数不是一个常量值,而是一个变量值,我们也可以在args属性里调用,如下面

<vt:function var="data" method="GetDataByName" type="$db" args="$name" />

 

但name变量也是需要赋值才可以使用(如通过SetValue方法),并且类型要一致,如果不一致,VT引擎将会尝试转换类型,如果类型转换成功则执行方法,如果失败将不会执行方法!!(参数类型不匹配时,因为会尝试转换,所以这里的效率会非常低,请尽量避免)

 

如果我们的方法里有多个参数,我们可以通过定义多个args属性,但要注意它们的定义顺序是同方法的参数定义顺序一样的。如下面的示例

public DataTable GetDataBy(string name, int category)
{
    //这里详细的代码
}

VT里的function标签我们就可以写成这样

<vt:function var="data" method="GetDataBy" type="$db" args="car" args="1" />

 

 

参数的自定义

上面的例子里,如果我们的方法参数非常多,用args定义是可以做到,但是却非常的不直观,并且如果参数定义的顺序或类型一错,将会导致我们的方法无法正确执行!如果能换一种方式,比如下面这样的定义

<vt:function var="data" method="GetDataBy" type="$db" pName="car" pCategory="1" />

这样我们的模板代码看起来就非常的直观明了。

 

VT模板里允许在标签里添加自定义属性,所以我们上面的标签定义是符合格式的,但是我们为了能使自定义属性当作参数使用,我们就需要改写GetDataBy方法,如下

public DataTable GetDataBy()
{
    var document = TemplateDocument.CurrentRenderingDocument;
    var tag = document == null ? null : document.CurrentRenderingTag;
    if (tag == null) return null;

    var name = tag.Attributes.GetValue("pName");
    var category = tag.Attributes.GetValue("pCategory").As<int>(0);

    //这里是详细的代码

}

GetDataBy方法变成了无参数方法,并在方法里我们调用了“TemplateDocument.CurrentRenderingDocument”获取当前正在呈现解析数据的模板文档对象,再通过“document.CurrentRenderingTag”获取当前呈现解析数据的模板标签对象。如果我们的GetDataBy方法是通过上面的function标签调用执行的,则“document.CurrentRenderingTag”获取到的标签对象就是此function标签,所以我们可以获取此标签里的所有自定义属性值,从而得到pName与pCategory里定义的值。

注:各个模板标签都有自己的关键属性,这些是无法在自定义属性里获取的,比如"id“、“name“这些是不能用做自定义属性的。

 

 

用户自定义方法

如果我们有些方法是私有的,比如

private DataTable GetUserData(object[] o)
{

}

或者匿名方法

UserDefinedFunction GetUserData = (o) =>
{
    //这里是详细的处理代码
};

对于这两种情况,我们是无法直接通过function标签调用的,因为我们无法写type属性!因为type属性需要类名或者是类实例变量,并且是只能调用公开方法

 

而对于这两种情况,则我们需要先在模板里注册用户自定义函数,才能通过function标签调用。如下示例

TemplateDocument document = TemplateDocument.FromFileCache(@"c:\template\test.html", Encoding.UTF8);
document.RegisterGlobalFunction("GetUserData", GetUserData);

注册了自定义函数后,我们就可以写无type属性的function标签,如下

<vt:function var="data" method="GetUserData" />

 

VT在处理这种没有type属性的方法时,将会在“自定义函数”列表里查找同名的方法,如果找到则执行方法,否则不处理。

 

小提示

对于无参数的实例方法,可以直接在变量表达式里执行,所以在任意标签里可直接使用,不一定需要通过function标签执行,如下面示例

<vt:set var="data" value="$db.GetData()" />
<vt:foreach from="$db.GetData()" item="data">.......</vt:foreach>
posted @ 2011-08-31 17:59  Kingthy  阅读(5098)  评论(5编辑  收藏  举报