破竹CMS 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
  • 扩展属性值查询
查询方法 说明
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("扩展属性名称")%>


相关条目[ ]

参考来源[ ]

取自“https://www.zzbaike.com/wiki/index.php?title=破竹CMS_SearchDocuments控件说明&oldid=50300”