DTcms帮助Word文档下载推荐.docx

1、loop循环标签loop循环标签主要是数据列表中使用的，其中自带有行号变量datarow_loop_id，该变量是从1开始参数说明：datarow：DataRow类型的变量，同一页面内不可重复，否则编译出错datatable：DataTable类型的变量，使用前请确保该参数已声明赋值-loop循环标签-%loop datarow datatable% .%/loop%foreach循环标签foreach标签和C#的语法是一样的，写法也差不多，相信技术人员一看就懂。注意与loop标签不同的是它没有自带的行号变量，需要手动声明。type：数据类型，如DataRowitem：数据类型的变量名，自定义

2、变量名list：数组、结构、对象、引用类型-foreach循环标签-%foreach（type item in list）%/foreach%for循环标签for标签和C#的语法也是一样的，一般很少用到。i：整型变量count：-for循环标签-%for（int i=0;i%/for%if判断语句标签if判断语句与C#的语法一样，支持二种写法，保留旧的写法-第一种格式写法（推荐）-%if（.）%else if（.）%/if%-第二种格式写法（旧写法）-%if .%else if .%continue退出当前循环标签循环标签中分支用以结束当前循环，直接进入下一次循环的标签，使用方式同传统程序一致

3、。-continue标签-%continue%-使用示例，当i等于5时退回并进入下一条循环-%if（i=5）%break结束循环标签在循环标签中用以结束循环，进入后续程序的标签，使用方式同传统程序一致 。-break标签-%break%-使用示例，当i大于5时结束循环-%if（i5）%获取GET传输参数标签获取URL地址GET传输的参数值-request标签，varname为参数名-requestvarname截取字符串长度标签当一个字符串的长度大于你想要的值时可使用该标签num：int类型，字符串长度-cutstring标签，.为变量-%cutstring（.,num）%日期格式转换标签把日

4、期字符串转换成你想要的格式strFormat：日期格式-datetostr标签，.为变量-%datetostr（.,strFormat）%-示例一：输出年月日格式的日期-%datetostr（varname,yyyy年MM月dd日）%-示例二：输出年月日时分秒格式的日期-%datetostr（varname,yyyy年MM月dd日HH时mm分ss秒）%整型格式转换标签当一个字符串的想转换成一个整型的数字时可使用该标签-strtoint标签，.为字符串变量-strtoint（.）直接输出内容标签当一个方法返回的是字符串内容，而我们又想直接在模板页中直接输出可使用该标签。该标签支持两种写法，推荐用

5、第一种。-第一种写法（推荐）-%=方法名（参数一,参数二,.）%-第二种写法（旧写法）-%write 方法名（参数一，参数二,.）% 声明变量与赋值标签和C#语法基本一致，需要声明或在需要接受一个方法返回的内容时可以使用该标签。可选，变量的类型，如果有type则首先创建对象再赋值，否则直接赋值ref：变量名，同一页面内不可重复expression：变量、常量或方法都可以%set type ref=expression%-示例一-%set int num=1%-再次使用时不用再声明-%set num=2%-示例二-%set DataTable dt=get_list（参数一,参数二,.）%set

6、 （type）ref=expression%set （int）num=1%set num=2%set （DataTable）dt=get_list（参数一,参数二,.）%通用标签在所有模板页面都可以使用，如果您下载的是DTcms的源码版，请查看项目下的Label文件夹，如果默认标签不够用的情况下，你也可以在里面新增一些自定义的标签，但记住编译一下整个项目。一、系统配置标签（变量）系统配置的一些信息，实际上是源码项目中的里面的属性，里面都有详细的备注与注释标签描述示例主站名称动力启航主站域名公司名称XX软件有限公司公司地址XX省XX市XX区XX号联系电话传真号码管理员网站备案号粤TC/ICP备X

7、X号网站安装目录，/代表放在根目录/网站后台管理目录admin是否开启生成静态，0不开启，1伪静态，2全静态1生成静态扩展名html手机网站状态，0关闭1开启手机网站绑定域名开启会员功能，0不开启，1开启开启评论审核，0不审核，1开启审核机制后台管理日志，0关闭，1开启是否关闭网站，0正常，1关闭网站关闭原因描述网站正在维护，请稍候访问.网站统计代码，支持HTMLscript.短信API地址，MD5加密字符串a34de42fededferkc63fe手机短信签名邮件STMP服务器加密连接邮件SMTP端口25发件人地址邮箱账号邮箱密码，内置加密算法发件人昵称网站管理员附件上传目录名upload附

8、件保存方式，1按年月日保存，2按年月/日/保存附件上传类型，以逗号分隔开gif,png,doc视频上传类型，以逗号分隔开mp4,flv附件上传大小，单位为KB2048视频上传大小，单位为KB图片上传大小，单位为KB1024图片最大高度（像素）图片最大宽度（像素）生成缩略图高度（像素）生成缩略图宽度（像素）图片水印类型，0关闭，1文字，2图片图片水印位置，1-99图片生成质量，0-10080图片水印文件水印透明度，1-105水印文字文字字体Arial水印文字大小（像素）12当前站点的配置信息，只能在当前模板页面中使用这些标签，它和上面的系统配置不同，例如当前访问的是站点A，加载的就是站点A的配置

9、信息。网站名称网站域名网站LOGO/upload.记录总数：totalcount页码：pagelist 余额明细分页列表标签根据SQL查询条件返回对应的余额明细分页列表，用循环输出。page_size： 每页显示条数，int类型page_index： 当前页码，int类型strwhere： SQL查询语句totalcount： 记录总数，out参数，int类型get_user_amount_list（page_size, page_index, strwhere, out totalcount）-示例：显示用户名为test余额明细分页列表-取得一个DataTable，page为当前页码变量，t

10、otalcount为已声明的变量-%set DataTable dt=get_user_amount_list（10, page, user_name=test, out totalcount）%-取得分页页码列表，action为变量，相关说明请查阅get_page_link分页标签-%set string pagelist=get_page_link（10, page, totalcount, useramount, action, _id_）%-使用循环输出-%foreach（DataRow dr in % 充值记录分页列表标签根据SQL查询条件返回对应的充值记录分页列表，用循环输出。ge

11、t_user_recharge_list（page_size, page_index, strwhere, out totalcount）显示用户名为test充值记录分页列表-%set DataTable dt=get_user_recharge_list（10, page, 邀请码列表标签根据SQL查询条件返回对应的邀请码列表，用循环输出。top： 显示条数，0为显示所有，int类型get_user_invite_list（top, strwhere）显示用户名为test的所有邀请码列表-%set DataTable dt=get_user_invite_list（0, 邀请码的状态标签根据

12、邀请码字符串返回一个布尔值，True为可用，False为不可用。str_code： 需要验证的邀请码字符串，string类型get_invite_status（str_code）验证邀请码字符串“ER98FE888”是否有效-%set bool status=get_invite_status（ER98FE888%if（status=true）% 该邀请码有效%else% 该邀请码已使用过或已过期七、订单调用标签（方法）位于类里面的方法，如果你是一个程序员，随时可以根据自己的要求添加你自己的方法。 统计订单数量标签根据查询条件统计订单总记录数。get_user_order_count（strw

13、here）查询用户名为test未完成的订单总数- 未完成订单：%=get_user_order_count（status%set DataTable dt=get_order_list（0, 订单分页列表标签根据SQL查询条件返回对应的订单分页列表，用循环输出。get_order_list（page_size, page_index, strwhere, out totalcount）显示用户名为test订单分页列表-%set DataTable dt=get_order_list（10, page, userorder 订单商品列表标签根据订单的ID查找对应的商品列表，返回的是List%se

14、t List%foreach modelt in ls）% 返回订单状态标签根据订单ID查询当前订单处理状态描述，例如：待付款。get_order_status（order_id）查询订单ID为5的状态描述- 订单状态：%=get_order_status（5）% 返回订单是否需要在线支付标签根据订单ID查询当前订单是否需要在线支付，返回布尔值，True代表需要在线支付，False代表不需要在线支付。get_order_payment_status（order_id）查询订单ID为5是否需要在线支付-%set bool status=get_order_payment_status（5）% .

15、九、配送方式调用标签（方法） 配送方式列表标签根据查询条件显示前几行配送方式列表，用循环输出。get_express_list（top, strwhere）查询所有配送方式列表-%set DataTable dt=get_express_list（0, 返回配送方式标题标签根据配送方式的ID查询该配送方式的标题名称。express_id： 配送方式的ID，int类型get_express_title（express_id）查询配送方式ID为5的标题名称- 配送方式：%=get_express_title（5）%十、支付方式调用标签（方法） 支付方式列表标签根据查询条件显示前几行支付方式列表，用

16、循环输出。get_payment_list（top, strwhere）%set DataTable dt=get_payment_list（0, 返回支付方式标题标签根据支付方式的ID查询该支付方式的标题名称。payment_id： 支付方式的ID，int类型get_payment_title（payment_id）查询支付方式ID为5的标题名称- 支付方式：%=get_payment_title（5）% 返回支付费用金额标签根据支付方式的ID查询该支付方式的手续费用，返回一个decimal类型的货币格式。total_amount： 参与计算的商品总金额，decimal类型get_payment_poundage_amount（payment_id,total_amount）查询支付方式ID为5，商品金额为100的支付手续费用- 支付手续费：%=get_payment_poundage_amount（5,100）%