datalist | 新亿CMS完全手册

[返回首页](#) # datalist <table width="200" border="0" cellspacing="1" bgcolor="#888888" id="tag_table"><tr><td bgcolor="#EFEFEF"><h1>datalist</h1></td> </tr><tr><td bgcolor="#EFEFEF">数据列表显示标签。</td> </tr><tr><td bgcolor="#EFEFEF">代码范例:  <datalist item="下级栏目"> <a href="{xyc:link}">{cc_Name}</a> </datalist>  </td> </tr></table> <table width="100%" border="0" cellspacing="1" bgcolor="#888888" id="tag_table"><tr><td colspan="4" bgcolor="#EFEFEF"><h3>属性</h3></td> </tr><tr><th bgcolor="#EFEFEF" width="8%"> 属性名 </th><th bgcolor="#EFEFEF">说明 </th><th bgcolor="#EFEFEF">可选参数 | 备注 </th><th bgcolor="#EFEFEF" width="6%">是否支持 </th></tr><tr><td bgcolor="#EFEFEF">itemnum</td> <td bgcolor="#EFEFEF">当前循环的第几个序列。默认此属性是从1开始，如果您设置为3，那么第一个循环的itemnum就是4</td> <td bgcolor="#EFEFEF"> </td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">itemindex</td> <td bgcolor="#EFEFEF">当前循环的第几个序列。默认此属性是从0开始，如果您设置为3，那么第一个循环的itemnum就是3</td> <td bgcolor="#EFEFEF"> </td> <td bgcolor="#EFEFEF"> </td> </tr></table> <table width="100%" border="0" cellspacing="1" bgcolor="#888888" id="tag_table"><tr><td colspan="4" bgcolor="#EFEFEF"><h3>特有变量</h3></td> </tr><tr><th bgcolor="#EFEFEF" width="8%"> 属性名 </th><th bgcolor="#EFEFEF">说明 </th><th bgcolor="#EFEFEF">可选参数 | 备注 </th><th bgcolor="#EFEFEF" width="6%">是否支持 </th></tr><tr><td bgcolor="#EFEFEF">{itemnum}</td> <td bgcolor="#EFEFEF">当前循环的第几个序列，默认是从1开始。</td> <td bgcolor="#EFEFEF"> </td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">{itemindex}</td> <td bgcolor="#EFEFEF">当前循环的第几个序列，默认是从0开始</td> <td bgcolor="#EFEFEF"> </td> <td bgcolor="#EFEFEF">是</td> </tr></table> <table width="200" border="0" cellspacing="1" bgcolor="#888888" id="tag_table"><tr><td colspan="4" bgcolor="#EFEFEF"><h3>TagSql组属性</h3></td> </tr><tr><th bgcolor="#EFEFEF" width="8%"> 属性名 </th><th bgcolor="#EFEFEF">说明 </th><th bgcolor="#EFEFEF">可选参数 | 备注 </th><th bgcolor="#EFEFEF" width="6%">是否支持 </th></tr><tr><td bgcolor="#EFEFEF">sql</td> <td bgcolor="#EFEFEF">支持T-sql数据脚本查询语句</td> <td bgcolor="#EFEFEF">形式为:select * from T 只支持select，不支持update,insert</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">dydata</td> <td bgcolor="#EFEFEF">是否将此数据缓存</td> <td bgcolor="#EFEFEF">dydata="a" 在使用的时候采用source="a" 即可获取缓存的数据</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">qkey</td> <td bgcolor="#EFEFEF">为{q_key}标签变量赋值</td> <td bgcolor="#EFEFEF"> </td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">table</td> <td bgcolor="#EFEFEF">指定当前数据主要服务的表名</td> <td bgcolor="#EFEFEF">xyc_Article指文章表，在模板的服务页应该为服务栏目的内容类型</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">msg</td> <td bgcolor="#EFEFEF">若没有数据,返回的msg信息</td> <td bgcolor="#EFEFEF">“暂无内容”</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">msghtml</td> <td bgcolor="#EFEFEF">是否在当前标签中显示msg信息</td> <td bgcolor="#EFEFEF">no:设定为此时，可以利用<cache name="msghtml"></cache>来显示</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">language</td> <td bgcolor="#EFEFEF">从标签中设置特定支持的语言或者 binfo 中指定</td> <td bgcolor="#EFEFEF">使用的标签中应该要有 <language>中文名称</language> 标签来使用语言转换</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">page</td> <td bgcolor="#EFEFEF">采用分页方式</td> <td bgcolor="#EFEFEF">on：当前采用分页方式。需要其他标签属性配合()</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">pageurl</td> <td bgcolor="#EFEFEF">分页时链接的页面</td> <td bgcolor="#EFEFEF">与 binfo.PageObj.PageUrl="index.aspx?"+xyurl.GetQueryRemovePage(Request.QueryString); 效果一样</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">pagedefaulturl</td> <td bgcolor="#EFEFEF">默认分页,一般用于设置第一页</td> <td bgcolor="#EFEFEF">如分页形式为art_1.html,art_2.html。则此处写art.html即可</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">pageshowfl</td> <td bgcolor="#EFEFEF">是否在分页代码中显示'首页','尾页'链接</td> <td bgcolor="#EFEFEF">1:显示,0:不显示</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">pageshowgo</td> <td bgcolor="#EFEFEF">是否在分页代码中显示跳转按钮</td> <td bgcolor="#EFEFEF">1:显示,0:不显示</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">linage</td> <td bgcolor="#EFEFEF">在当前分页标签中显示的条目数</td> <td bgcolor="#EFEFEF">1-150000之间的任意整行数字</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">pagesort</td> <td bgcolor="#EFEFEF">排序属性，与sql语句的用意order相似</td> <td bgcolor="#EFEFEF">在使用分页(page="on")直接使用，未使用分页时配合sql="*** {order} "来使用。 在动态程序中可以通过i.Q_keyArry.Add("{pagesort}", "s_ID desc");,前台模板页使用 sql="** {order}" pagesort="{pagesort}" 来获取</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">where</td> <td bgcolor="#EFEFEF">查询条件，与sql语句where用意相似</td> <td bgcolor="#EFEFEF">此属性主要与sql配合使用，如 sql="** where"或 sql="*** {where}" 都可以与where="1=1"配合查询</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">field</td> <td bgcolor="#EFEFEF">指定当前数据中，关键的字段</td> <td bgcolor="#EFEFEF">field="art_ID"</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">source</td> <td bgcolor="#EFEFEF">当前标签使用数据源</td> <td bgcolor="#EFEFEF">如<view source="a"></a> 此属性与另一个当前模板中的标签dydata配合使用。缓存的标签要在使用source的位置之上。采用此属性时，sql属性将不解释。</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">top</td> <td bgcolor="#EFEFEF">要显示的数据条目</td> <td bgcolor="#EFEFEF">一般用于此标签里的数据是通过source来读取时采用此属性。</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">pagehtml</td> <td bgcolor="#EFEFEF">是否在当前标签显示分页代码</td> <td bgcolor="#EFEFEF">如果设置为pagehtml="no"，可以利用<cache name="pagehtml"></cache>来显示</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">rowtocolumn</td> <td bgcolor="#EFEFEF">行转列配置属性</td> <td bgcolor="#EFEFEF">rowtocolumn="ItemName:ValueDate|" 常用在视图数据中，同样的数据会出现多行，只是后面的某个列的行数据不一样，这样便可以采用此属性。建议查看数据库视图:xyc_ViewContentList</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">columtreestyle</td> <td bgcolor="#EFEFEF">当前栏目存在于‘栏目树’时显示的样式</td> <td bgcolor="#EFEFEF">columtreestyle=".active" ,类似与在二级菜单显示时，当前页的二级栏目在导航条中会着色显示</td> <td bgcolor="#EFEFEF">是</td> </tr><tr><td bgcolor="#EFEFEF">item</td> <td bgcolor="#EFEFEF">代表一组配置好的属性</td> <td bgcolor="#EFEFEF">item="文章列表"时，便会自动读取预配置好的一组属性。(sql,top,where....等等)</td> <td bgcolor="#EFEFEF">是</td> </tr></table> [返回首页](#) 新亿乐天网络技术(北京)有限责任公司 © 2001 - 2009 XinYi Inc. 问题和建议请反馈至：[jianyi@xinyicms.com](#) 官网: [www.xinyicms.com](http://www.xinyicms.com "新亿内容管理系统")