ASP.Net 模板引擎 nVelocity使用语法

一、nVelocity定义 nVelocity是一个基于.NET的模板引擎。它定义了简单的模板语言从HTML页面中引用由.NET代码定义的对象，和引用外部文件等。从而使得界面设计人员与.NET程序开发人员基本分离。以下总结了网上比较常用的模板标记，以及本人对nVelocity的认识。 一、nVelocity的常用功能简介 1、 在页面中定义变量，并进行简单的运算。 2、 在页面中获得对后台程序实体对象的引用。 3、 在页面中迭代实体对象集合。 4、 在页面中获得实体对象的属性，及其方法。 5、 对逻辑判读语句的支持。 6、 对外部文件的引用。 7、 对外部文件的解析。 二、nVelocity的工作原理 可以使用.NET的反射实现。以下是nVelocity对迭代实体类的简单实现步骤： 1、 定义People类，并拥有Name与Sex属性。表示一个人。 2、 在页面中列出人物列表，则输入以下代码： #foreach($p in $ps) <p>欢迎您：$p.Name</p> #end 3、 获取人物列表，保存在_List中。并指定页面中的字符串“ps”对应_List。 4、以文本方式读取模板文件，并匹配#foreach…#end段，如果匹配到则继续匹配$X in $XX 段，分别记录用于保存集合与单项的字符，本次为“p”与“ps”。 5         用Type对象的GetProperties()方法获取_list中每一项的所有属性，并在 #foreach  #end段中循环将$p + 属性名称替换为当前对象的当前属性的值。当然如果要调用对象的方法也可以用同样的方式获得。 三、基本语法 1、特殊字符介绍 A、“#”：表示开始做什么事情。 B、“$”：表示用于获得什么。 C、“##“：单行注释。 D、 “#*… …*#”：多行注释。 2、关键字 A、 Set：开始做什么事情，比如定义变量，给变量重新赋值等。 B、 Foreach：迭代语句 C、 If：条件判断语句 D、 Elseif E、  Else F、  Include：对外部文件的引用，开始位置为模板路径。 G、 Parse：对外部文件的引用，并用nVelocity方式解析。 H、 Macro：创建宏，可以重复做某件事，类似于方法。 I、   Even：双数执行 J、   Odd ：单数执行 K、  Each：每次都执行 （备注：所有变量在未定义之前不能使用（因为我们习惯了有全局变量的习惯）。.NET后台定义的对象除外。模板语言区分大小写，所有的关键字必须为小写，上面的列表不是很全） 四、使用示例 1、  在页面中使用变量 定义变量：#set($a = “CNF”) 引用变量：欢迎光临：$a 定义变量：#set($a = 1) 运算：#set($a = $a + 1) 输出：$a   ##得：2 运算：#set($a = $a*5) 输出：$a   ##得：10 （备注：从以上可以看出nVelocity的替换顺序与.NET程序代码的执行基本一致，如果放在Foreach语句块中可以实现累加。并用If语句获得行号，对特殊行号的内容特殊处理。所有变量在未定义之前不能使用，.NET后台对象除外） 2、  在页面中使用条件判断语句 #if ($p.StrSex == “女”) #set($Sex = “女士”) #elseif ($p.StrSex == “男”) #set($Sex = “先生”) #elseif ($p.StrSex == “无”) #set($Sex = “人妖”) #else #set($Sex = “怪物”) #end （备注：可以嵌套在Foreach语句块中，用于对每个列表对象进行特殊显示处理。） 3、  创建宏，可以当做方法使用。 创建：#macro(Add $a $b) #set($c = $a + $b) <p>最后结果：$c</p> #end 调用：#Add(1 2) （备注：模板引擎的初始化方法有3种，一种参数为模板文件内容，一种是带模板文件地址。结果发现带模板文件内容的，在应用宏的时候好像有点问题。另外一个就是假如在宏里面加入一个判断语句，则可以实现递归调用。） 4、  使用对象方法 定义变量：#set($str = “CNF”) 调用方法：$str.SubString(0,1) 输出：C 定义变量：#set($a = 123) 调用方法：$a.GetType() 输出：System.Int32 （备注：不管是.NET代码定义的对象，还是设计人员在页面中定义的变量，都可以使用对象的方法及属性，这一点非常强大。） 5、  使用even与odd简化代码，each辅助 如上面所说用IF语句可以在列表中为每行创建不同的样式，但如果只需要区分单行与双行的话，可以使用even与odd简化代码。如下： #foreach($p in $ps) #even <p>双行：$p.StrName</p> #odd <p>单行：$p.StrName</p> #end （备注：在使用这两个关键字时，出现了与创建宏一样的问题，即在初始化模板引 引擎的时候，如果是用模板文件内容初始化的，会出现问题） 6、  引用外部文件 Include与parse都有引入外部文件的作用，不同的是parse会根据nVelocity模板语言解析外部文件。也就是说如果引入当前模板，则会出现死循环。 7、  使用Foreach语句 上面多次列出Foreach语句，相信已经知道它的作用。即循环列出一组对象集合。比如：#foreach($p in $ps)，其中$ps需要与后台代码中具体的实体类名称对应，$p代表$ps中的其中一项。上面已经提到过，即$p可以调用实体类的属性和方法。 （备注：#foreach 语句必须以#end结束） 8、  创建数组 创建：#set($List = [“男”,”女”]) 遍历：#foreach($Item in $List) <p>List成员：$Item</p> #end 输出：List成员：男 List成员：女 五、希望大家在看过此文以后，能帮我继续完善。