破竹CMS
>
帮助文档
>
开发控件介绍
> SearchDocuments
SearchDocuments：查询文档绑定控件
<pz:SearchDocuments runat="server" EnableViewState="false" CategoryID="" Path="" ItemsPerRow="" PageIndex="" PageSize="" PagerID="" ReturnCount="false/true" SelectIndex="" ShowHeaderFooterOnNone="">
<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>
<Where>
查询条件
</Where>
<Sorts>
<pz:Sort SortBy="排序列名" SorOrder="Ascending/Descending" />
......
</Sorts>
<Queries>
<pz:PrefixQuery PropertyDefinitionID="扩展属性ID" QueryKeyWord="查询关键词" Order="false/true" SorOrder="Ascending/Descending" />
<pz:RangeQuery PropertyDefinitionID="扩展属性ID" Lower="最小值" Upper="最大值" Order="false/true" SorOrder="Ascending/Descending" />
<pz:TermQuery PropertyDefinitionID="扩展属性ID" QueryKeyWord="查询关键词" Unequal="不匹配查询" Order="false/true" SorOrder="Ascending/Descending" />
<pz:WildcardQuery PropertyDefinitionID="扩展属性ID" QueryWildcard="查询关键词" Order="false/true" SorOrder="Ascending/Descending" />
</Queries>
</pz:SearchDocuments>
属性说明：
| 属性名称 |
说明 |
| runat |
指示控件在服务器端运行；值：server；每个控件都必须设置该值 |
| EnableViewState |
是否在客户端保持视图状态；需要向服务器回发时才需要启用；默认值为true；当不需要回发时应设为false，可以提高性能； |
| CategoryID |
指定一个栏目的编号，查询该栏目下的文档 |
| Path |
当没有设定CategoryID值时，也可以设置Path的值，代表指定的栏目； |
| PageSize |
指定绑定文档的集合数 |
| PageIndex |
指定绑定文档的页索引 |
| PagerID |
指定分页控件的ID，该分页控件必须是实现Pozhu.UI.WebControls.IPager接口的分布控件； |
| ReturnCount |
是否返回总记录数；为优化需要默认为不返回总记录数，当指定了PagerID时强制返回总记录数； |
| ItemsPerRow |
在栏目集合循环ItemsPerRow次后呈现RowSeparatorTemplate模板数据 |
| SelectIndex |
选中的索引集合项，呈现SeparatorTemplate模板数据 |
| ShowHeaderFooterOnNone |
当栏目集合数为0时，是否显示HeaderTemplate和FooterTemplate模板的数据 |
<where></where>：根据栏目、文档的基本属性查询
| 栏目基本属性 |
说明 |
| SiteID |
栏目所在站点的站点编号 |
| CategoryID |
栏目在数据库中的编号 |
| Path |
栏目的路径 |
| Title |
栏目名称 |
| CreateDate |
栏目创建时间 |
| SortOrder |
栏目的排序序号 |
| 文档基本属性 |
说明 |
| documentID |
文档在数据库中的编号 |
| categoryID |
文档所在栏目的编号 |
| subject |
文档的标题 |
| Name |
文档的别名 |
| createDate |
文档的创建时间 |
| updateDate |
文档的更新时间 |
| userID |
文档所属用户的编号 |
| TotalViews |
文档被读次数 |
| TotalRatings |
文档评价值 |
该查询方法使用SQL语句语法，根据栏目属性条件查询要在属性前面加上"category."，根据文档属性条件查询在属性前面加上"document."如：查询userID为2845的所有文档<where>document.userID=2845</where>
<Sorts></Sorts>：根据文档的基本属性排序，默认是按文档的创建日期降序排序的；注：不支持栏目基本属性排序
| 参数 |
说明 |
| SortBy |
指定文档排序的文档属性名称 |
| SorOrder |
升序或降序排序，取值：Ascending/Descending |
<Sorts>
<pz:Sort SortBy="createDate" SorOrder="Ascending" />
</Sorts>
扩展属性值查询：
| 查询方法 |
说明 |
| TermQuery |
用于查询某个特定的词，常用于查询关键字。
PropertyDefinitionID：扩展属性的编号
QueryKeyWord：查询的关键词
Unequal：是否按不匹配查询
Order：是否需要排序
SorOrder：如果需要排序，是升序还是降序排序
|
| PrefixQuery |
用于搜索是否包含某个特定前缀。
PropertyDefinitionID：扩展属性的编号
QueryKeyWord：查询的前缀关键词
Order：是否需要排序
SorOrder：如果需要排序，是升序还是降序排序
|
| RangeQuery |
用于指定一个范围查询，通常用于日期范围和数值范围查询
PropertyDefinitionID：扩展属性的编号
Lower：查询范围的起始值
Upper：查询范围的结束值
Order：是否需要排序
SorOrder：如果需要排序，是升序还是降序排序
|
| WildcardQuery |
通配符搜索，使用Sql的通配符语法
PropertyDefinitionID：扩展属性的编号
QueryWildcard：含有通配符的关键词
Order：是否需要排序
SorOrder：如果需要排序，是升序还是降序排序
|
模板说明：
| 模板名称 |
说明 |
| LeaderTemplate |
如果定义，则可以确定列表输出前的内容和布局。如果没有定义，则不呈现 |
| HeaderTemplate |
如果定义，则可以确定列表标头的内容和布局。如果没有定义，则不呈现标头 |
| ItemTemplate |
定义列表中项目的内容和布局。此模板为必选 |
| SeparatorTemplate |
如果定义，则呈现在项（以及交替项）之间。如果未定义，则不呈现分隔符 |
| AlternatingItemTemplate |
如果定义，则可以确定交替（从零开始的奇数索引）项的内容和布局。如果未定义，则使用 ItemTemplate; |
| RowSeparatorTemplate |
如果定义且设定了ItemsPerRow的值，则循环呈现在ItemsPerRow项后； |
| SelectTemplate |
如果定义且设计了SelectIndex的值，则呈现在SelectIndex项 |
| NoneTemplate |
如果定义且当列表集合数为0个时呈现； |
| FooterTemplate |
如果定义，则可以确定列表注脚的内容和布局。如果没有定义，则不呈现注脚 |
| TrailerTemplate |
如果定义，则可以确定列表输出后的内容和布局。如果没有定义，则不呈现 |
模板中绑定的语法：<%# Eval("属性名称")%>绑定扩展属性的语法(有点复杂)：<%# ((Document)Container.DataItem).Profile.GetPropertyValue("扩展属性名称")%>