DTcms帮助Word文档下载推荐.docx
《DTcms帮助Word文档下载推荐.docx》由会员分享，可在线阅读，更多相关《DTcms帮助Word文档下载推荐.docx（15页珍藏版）》请在冰豆网上搜索。
loop循环标签
loop循环标签主要是数据列表中使用的，其中自带有行号变量datarow__loop__id，该变量是从1开始
参数说明：
datarow：
DataRow类型的变量，同一页面内不可重复，否则编译出错
datatable：
DataTable类型的变量，使用前请确保该参数已声明赋值
--loop循环标签-->
%loopdatarowdatatable%>
...
%/loop%>
foreach循环标签
foreach标签和C#的语法是一样的，写法也差不多，相信技术人员一看就懂。
注意与loop标签不同的是它没有自带的行号变量，需要手动声明。
type：
数据类型，如DataRow
item：
数据类型的变量名，自定义变量名
list：
数组、结构、对象、引用类型
--foreach循环标签-->
%foreach（typeiteminlist）%>
%/foreach%>
for循环标签
for标签和C#的语法也是一样的，一般很少用到。
i：
整型变量
count：
--for循环标签-->
%for（inti=0;
i<
=count;
i++）%>
%/for%>
if判断语句标签
if判断语句与C#的语法一样，支持二种写法，保留旧的写法
--第一种格式写法（推荐）-->
%if（...）%>
%elseif（...）%>
%/if%>
--第二种格式写法（旧写法）-->
%if...%>
%elseif...%>
continue退出当前循环标签
循环标签中分支用以结束当前循环，直接进入下一次循环的标签，使用方式同传统程序一致。
--continue标签-->
%continue%>
--使用示例，当i等于5时退回并进入下一条循环-->
%if（i==5）%>
break结束循环标签
在循环标签中用以结束循环，进入后续程序的标签，使用方式同传统程序一致。
--break标签-->
%break%>
--使用示例，当i大于5时结束循环-->
%if（i>
5）%>
获取GET传输参数标签
获取URL地址GET传输的参数值
--request标签，varname为参数名-->
{request[varname]}
截取字符串长度标签
当一个字符串的长度大于你想要的值时可使用该标签
num：
int类型，字符串长度
--cutstring标签，{...}为变量-->
%cutstring（{...},num）%>
日期格式转换标签
把日期字符串转换成你想要的格式
strFormat：
日期格式
--datetostr标签，{...}为变量-->
%datetostr（{...},strFormat）%>
--示例一：
输出年月日格式的日期-->
%datetostr（{varname},yyyy年MM月dd日）%>
--示例二：
输出年月日时分秒格式的日期-->
%datetostr（{varname},yyyy年MM月dd日HH时mm分ss秒）%>
整型格式转换标签
当一个字符串的想转换成一个整型的数字时可使用该标签
--strtoint标签，{...}为字符串变量-->
{strtoint（{...}）}
直接输出内容标签
当一个方法返回的是字符串内容，而我们又想直接在模板页中直接输出可使用该标签。
该标签支持两种写法，推荐用第一种。
--第一种写法（推荐）-->
%=方法名（参数一,参数二,...）%>
--第二种写法（旧写法）-->
%write方法名（参数一，参数二,...）%>
声明变量与赋值标签
和C#语法基本一致，需要声明或在需要接受一个方法返回的内容时可以使用该标签。
可选，变量的类型，如果有type则首先创建对象再赋值，否则直接赋值
ref：
变量名，同一页面内不可重复
expression：
变量、常量或方法都可以
%set[type]ref=expression%>
--示例一-->
%setintnum=1%>
--再次使用时不用再声明-->
%setnum=2%>
--示例二-->
%setDataTabledt=get_list（参数一,参数二,...）%>
%set[（type）]{ref}=expression%>
%set（int）{num}=1%>
%set{num}=2%>
%set（DataTable）{dt}=get_list（参数一,参数二,...）%>
通用标签在所有模板页面都可以使用，如果您下载的是DTcms的源码版，请查看项目下的Label文件夹，如果默认标签不够用的情况下，你也可以在里面新增一些自定义的标签，但记住编译一下整个项目。
一、系统配置标签（变量）
系统配置的一些信息，实际上是源码项目中的里面的属性，里面都有详细的备注与注释
标签
描述
示例
{}
主站名称
动力启航
主站域名
公司名称
XX软件有限公司
公司地址
XX省XX市XX区XX号
联系电话
传真号码
管理员
网站备案号
粤TC/ICP备XX号
网站安装目录，/代表放在根目录
/
网站后台管理目录
admin
是否开启生成静态，0不开启，1伪静态，2全静态
1
生成静态扩展名
html
手机网站状态，0关闭1开启
手机网站绑定域名
开启会员功能，0不开启，1开启
开启评论审核，0不审核，1开启审核机制
后台管理日志，0关闭，1开启
是否关闭网站，0正常，1关闭
网站关闭原因描述
网站正在维护，请稍候访问...
网站统计代码，支持HTML
script>
...<
/script>
短信API地址
，MD5加密字符串
a34de42fededferkc63fe
手机短信签名
邮件STMP服务器
加密连接
邮件SMTP端口
25
发件人地址
邮箱账号
邮箱密码，内置加密算法
发件人昵称
网站管理员
附件上传目录名
upload
附件保存方式，1按年月日保存，2按年月/日/保存
附件上传类型，以逗号分隔开
gif,png,doc
视频上传类型，以逗号分隔开
mp4,flv
附件上传大小，单位为KB
2048
视频上传大小，单位为KB
图片上传大小，单位为KB
1024
图片最大高度（像素）
图片最大宽度（像素）
生成缩略图高度（像素）
生成缩略图宽度（像素）
图片水印类型，0关闭，1文字，2图片
图片水印位置，1-9
9
图片生成质量，0-100
80
图片水印文件
水印透明度，1-10
5
水印文字
文字字体
Arial
水印文字大小（像素）
12
当前站点的配置信息，只能在当前模板页面中使用这些标签，它和上面的系统配置不同，例如当前访问的是站点A，加载的就是站点A的配置信息。
网站名称
网站域名
网站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,outtotalcount）
--示例：
显示用户名为test余额明细分页列表-->
--取得一个DataTable，page为当前页码变量，totalcount为已声明的变量-->
%setDataTabledt=get_user_amount_list（10,page,"
user_name='
test'
"
outtotalcount）%>
--取得分页页码列表，action为变量，相关说明请查阅get_page_link分页标签-->
%setstringpagelist=get_page_link（10,page,totalcount,"
useramount"
action,"
__id__"
）%>
--使用循环输出-->
%foreach（DataRowdrin%>
充值记录分页列表标签
根据SQL查询条件返回对应的充值记录分页列表，用循环输出。
get_user_recharge_list（page_size,page_index,strwhere,outtotalcount）
显示用户名为test充值记录分页列表-->
%setDataTabledt=get_user_recharge_list（10,page,"
邀请码列表标签
根据SQL查询条件返回对应的邀请码列表，用循环输出。
top：
显示条数，0为显示所有，int类型
get_user_invite_list（top,strwhere）
显示用户名为test的所有邀请码列表-->
%setDataTabledt=get_user_invite_list（0,"
邀请码的状态标签
根据邀请码字符串返回一个布尔值，True为可用，False为不可用。
str_code：
需要验证的邀请码字符串，string类型
get_invite_status（str_code）
验证邀请码字符串“ER98FE888”是否有效-->
%setboolstatus=get_invite_status（"
ER98FE888"
%if（status==true）%>
该邀请码有效
%else%>
该邀请码已使用过或已过期
七、订单调用标签（方法）
位于类里面的方法，如果你是一个程序员，随时可以根据自己的要求添加你自己的方法。
统计订单数量标签
根据查询条件统计订单总记录数。
get_user_order_count（strwhere）
查询用户名为test未完成的订单总数-->
未完成订单：
%=get_user_order_count（"
status<
3anduser_name='
订单列表标签
根据查询条件显示前几行订单列表，用循环输出。
get_order_list（top,strwhere）
查询用户名为test所有未完成的订单列表-->
%setDataTabledt=get_order_list（0,"
订单分页列表标签
根据SQL查询条件返回对应的订单分页列表，用循环输出。
get_order_list（page_size,page_index,strwhere,outtotalcount）
显示用户名为test订单分页列表-->
%setDataTabledt=get_order_list（10,page,"
userorder"
订单商品列表标签
根据订单的ID查找对应的商品列表，返回的是List<
实体对象
order_id：
订单ID，int类型
get_order_goods_list（order_id）
--查询订单ID为5的商品信息-->
%setList<
ls=get_order_goods_list（5）%>
%foreachmodeltinls）%>
返回订单状态标签
根据订单ID查询当前订单处理状态描述，例如：
待付款。
get_order_status（order_id）
查询订单ID为5的状态描述-->
订单状态：
%=get_order_status（5）%>
返回订单是否需要在线支付标签
根据订单ID查询当前订单是否需要在线支付，返回布尔值，True代表需要在线支付，False代表不需要在线支付。
get_order_payment_status（order_id）
查询订单ID为5是否需要在线支付-->
%setboolstatus=get_order_payment_status（5）%>
.
九、配送方式调用标签（方法）
配送方式列表标签
根据查询条件显示前几行配送方式列表，用循环输出。
get_express_list（top,strwhere）
查询所有配送方式列表-->
%setDataTabledt=get_express_list（0,"
返回配送方式标题标签
根据配送方式的ID查询该配送方式的标题名称。
express_id：
配送方式的ID，int类型
get_express_title（express_id）
查询配送方式ID为5的标题名称-->
配送方式：
%=get_express_title（5）%>
十、支付方式调用标签（方法）
支付方式列表标签
根据查询条件显示前几行支付方式列表，用循环输出。
get_payment_list（top,strwhere）
%setDataTabledt=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）%>
升级会员 