破竹CMS
>
帮助文档
>
开发控件介绍
> DocumentRepeater
DocumentRepeater：文档绑定控件
<pz:DocumentRepeater runat="server" EnableViewState="false" CategoryID="" Path="" IncludeChildCategories="false/true" ItemsPerRow="" PageIndex="" PageSize="" PagerID="" ReturnCount="false/true" SelectIndex="" ShowHeaderFooterOnNone="" TypeName="">
<LeaderTemplate>
列表输入前的Html模板内容
</LeaderTemplate>
<HeaderTemplate>
列表表头的Html模板内容
</HeaderTemplate>
<ItemTemplate>
列表项的Html模板内容
</ItemTemplate>
<SeparatorTemplate>
列表项（交替项）之间分隔的Html模板内容
</SeparatorTemplate>
<AlternatingItemTemplate>
列表交替项的Html模板内容
</AlternatingItemTemplate>
<RowSeparatorTemplate>
循环ItemsPerRow次数后的Html模板内容
</RowSeparatorTemplate>
<SelectTemplate>
选中项的的Html模板内容
</SelectTemplate>
<NoneTemplate>
列表集合项数为0时的Html模板内容
</NoneTemplate>
<FooterTemplate>
列表表尾的Html模板内容
</FooterTemplate>
<TrailerTemplate>
列表全部输出后的Html模板内容
</TrailerTemplate>
</pz:DocumentRepeater>
属性说明：
| 属性名称 |
说明 |
| runat |
指示控件在服务器端运行；值：server；每个控件都必须设置该值 |
| EnableViewState |
是否在客户端保持视图状态；需要向服务器回发时才需要启用；默认值为true；当不需要回发时应设为false，可以提高性能； |
| CategoryID |
指定一个栏目的编号，绑定该栏目下的文档 |
| Path |
当没有设定CategoryID值时，也可以设置Path的值，代表指定的栏目； |
| IncludeChildCategories |
是否包含子栏目下的文档；可选值为false/true；默认值为true |
| TypeName |
指定绑定文档的文档类型，可指定多个文档类型，用","隔开； |
| PageSize |
指定绑定文档的集合数 |
| PageIndex |
指定绑定文档的页索引 |
| PagerID |
指定分页控件的ID，该分页控件必须是实现Pozhu.UI.WebControls.IPager接口的分布控件； |
| ReturnCount |
是否返回总记录数；为优化需要默认为不返回总记录数，当指定了PagerID时强制返回总记录数； |
| ItemsPerRow |
在栏目集合循环ItemsPerRow次后呈现RowSeparatorTemplate模板数据 |
| SelectIndex |
选中的索引集合项，呈现SeparatorTemplate模板数据 |
| ShowHeaderFooterOnNone |
当栏目集合数为0时，是否显示HeaderTemplate和FooterTemplate模板的数据 |
模板说明：
| 模板名称 |
说明 |
| LeaderTemplate |
如果定义，则可以确定列表输出前的内容和布局。如果没有定义，则不呈现 |
| HeaderTemplate |
如果定义，则可以确定列表标头的内容和布局。如果没有定义，则不呈现标头 |
| ItemTemplate |
定义列表中项目的内容和布局。此模板为必选 |
| SeparatorTemplate |
如果定义，则呈现在项（以及交替项）之间。如果未定义，则不呈现分隔符 |
| AlternatingItemTemplate |
如果定义，则可以确定交替（从零开始的奇数索引）项的内容和布局。如果未定义，则使用 ItemTemplate; |
| RowSeparatorTemplate |
如果定义且设定了ItemsPerRow的值，则循环呈现在ItemsPerRow项后； |
| SelectTemplate |
如果定义且设计了SelectIndex的值，则呈现在SelectIndex项 |
| NoneTemplate |
如果定义且当列表集合数为0个时呈现； |
| FooterTemplate |
如果定义，则可以确定列表注脚的内容和布局。如果没有定义，则不呈现注脚 |
| TrailerTemplate |
如果定义，则可以确定列表输出后的内容和布局。如果没有定义，则不呈现 |
模板中绑定的语法：<%# Eval("属性名称")%>绑定扩展属性的语法(有点复杂)：<%# ((Document)Container.DataItem).Profile.GetPropertyValue("扩展属性名称")%>