WSS3.0开发-过滤列表内容（2）--一个增强的列表元数据查询webpart（SmartQueryWebPart）

WSS3.0开发-过滤列表内容（2）--一个增强的列表元数据查询webpart（SmartQueryWebPart）

SmartQuery 是一个WSS（MOSS）列表查询解决方案，可以给WSS的所有列表添加字段查询的功能。

您需要做的只是开发一个查询字段布局用户控件，声明查询字段及其排列，然后利用SmartQueryWebPart加载这个用户控件即可。

使用步骤：
----------------------------------------------------------------------
1）首先下载： http://files.cnblogs.com/jianyi0115/SmartQuery_v1.0.zip 并解压。

2） 将CodeArt.SharePoint.CamlQuery.dll和CodeArt.SharePoint.SmartQuery.dll加入GAC。

3）在站点的web.config的 <SafeControls>节点下添加webpart声明：
<SafeControl Assembly="CodeArt.SharePoint.SmartQuery, Version=1.0.0.0, Culture=neutral, PublicKeyToken=df96d56002e5fe16" Namespace="CodeArt.SharePoint.SmartQuery" TypeName="*" Safe="True" AllowRemoteDesigner="True" />

4）将示例查询布局用户控件 CodeArt_ExampleQueryLayout.ascx和CodeArt_ExampleQueryLayout2.ascx
复制到C:"Program Files"Common Files"Microsoft Shared"web server extensions"12"TEMPLATE"CONTROLTEMPLATES

5）进入> Web 部件库 > 新建 Web 部件   页面，添加 CodeArt.SharePoint.SmartQuery.SmartQueryWebPart。

6）进行测试：示例控件是为 任务 列表开发的，因此，转到一个任务列表的AllItem.aspx页面，进入编辑模式，
添加 SmartQueryWebPart。

7）退出编辑模式，就可以看到效果了。


如何开发自己的查询布局控件：
----------------------------------------------------------------------------

1）查询布局用户控件可以是任意用户控件，只要实现了CodeArt.SharePoint.SmartQuery.ICamlProvider接口即可。

2）为了简化开发，用户控件可以从 CodeArt.SharePoint.SmartQuery.BaseLayoutControl继承，参考CodeArt_ExampleQueryLayout.ascx的代码：

<% @ Control Language="C#"
 Inherits="CodeArt.SharePoint.SmartQuery.BaseLayoutControl,CodeArt.SharePoint.SmartQuery, Version=1.0.0.0, Culture=neutral, PublicKeyToken=df96d56002e5fe16" %>
<% @ Register Tagprefix="codeArt" Namespace="CodeArt.SharePoint.SmartQuery" Assembly="CodeArt.SharePoint.SmartQuery, Version=1.0.0.0, Culture=neutral, PublicKeyToken=df96d56002e5fe16"  %>
  < div >      
      < table >
      < tr >
      < td >
     标题:
      </ td >
      < td >< codeArt:QueryControl  runat ="server"  FieldName ="标题"  id ="f1"  ShowTitle ="false"  /></ td >
      < td >
     截止日期:
      </ td >
      < td >  < codeArt:QueryControl  runat ="server"  FieldName ="截止日期"  id ="f2"  ShowTitle ="false" /></ td >
       < td >
     分配对象:
      </ td >
      < td >  < codeArt:QueryControl  runat ="server"  FieldName ="分配对象"  id ="f3"  ShowTitle ="false" /></ td >
       < td >
     优先级:
      </ td >
      < td >  < codeArt:QueryControl  runat ="server"  FieldName ="优先级"  id ="f4"  ShowTitle ="false" /></ td >
      < td >
      < asp:Button  runat ="Server"  Text ="查询"  ID ="btn1"  />
      </ td >
      </ tr >
      </ table >      
</ div >

说明：QueryControl表示一个查询字段，它会按照字段类型呈现不同的样式，如 文本框，下拉列表，时间选择，人员选择等。

3）如果要进行更高级的控制，可以重载BaseLayoutControl的QueryExpression属性，来实现自己的查询条件控制。

请参考CodeArt_ExampleQueryLayout2.ascx的代码：

<% @ Control Language="C#"
 Inherits="CodeArt.SharePoint.SmartQuery.BaseLayoutControl,CodeArt.SharePoint.SmartQuery, Version=1.0.0.0, Culture=neutral, PublicKeyToken=df96d56002e5fe16" %>
<% @ Register Tagprefix="codeArt" Namespace="CodeArt.SharePoint.SmartQuery" Assembly="CodeArt.SharePoint.SmartQuery, Version=1.0.0.0, Culture=neutral, PublicKeyToken=df96d56002e5fe16"  %>
<% @ Register Tagprefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"  %>  <% @ Register Tagprefix="Utilities" Namespace="Microsoft.SharePoint.Utilities" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"  %>
<% @ Import Namespace="Microsoft.SharePoint"  %>

<% @ Assembly Name="CodeArt.SharePoint.CamlQuery, Version=1.0.0.0, Culture=neutral, PublicKeyToken=43536cfde91ea799"  %>
<% @ Import Namespace="CodeArt.SharePoint.CamlQuery"   %>

< script  runat ="server" >
 
    /// <summary>
    /// 创建查询表达式
    /// </summary>
    public override CamlExpression QueryExpression
    {
        get
        {
            CamlExpression expr = null;

            QueryField title = new QueryField("标题", false);

            QueryField des = new QueryField("说明", false);

            if (txtTitle.Text != "")
                expr = title.Contains(txtTitle.Text);

            if (txtDes.Text != "")
                expr = Append( expr , des.Contains( txtDes.Text ) );
           
            return expr ;                    
        }
    }

    /// <summary>
    /// 链接查询条件
    /// </summary>
    /// <param name="expr1"></param>
    /// <param name="expr2"></param>
    /// <returns></returns>
    CamlExpression Append( CamlExpression expr1 , CamlExpression expr2 )
    {
        if (expr1 == null)
            return expr2;
        else
            return expr1 && expr2;       
    }

</ script >
  < div >      
      < table >
      < tr >
      < td >
     标题:
      </ td >
      < td >
      < asp:TextBox  runat ="server"  ID ="txtTitle" ></ asp:TextBox >
      </ td >
      < td >
     说明:
      </ td >
      < td >  < asp:TextBox  runat ="server"  ID ="txtDes" ></ asp:TextBox ></ td >
      < td >
      < asp:Button  runat ="Server"  Text ="查询"  ID ="btn1"  />
      </ td >
      </ tr >
      </ table >           
</ div >

--------------------------------------------
说明：SmartQuery采用CamlQuery类库实现查询条件的拼接，CamlQuery类库类库的使用参见压缩包里的CamlQuery_Manual.txt。
或参考以下链接：
WSS3.0开发--你还在为写CAML痛苦吗？
CodeArt.SharePoint.CamlQuery_0.9发布(源码)

4）布局控件开发好后，放到CONTROLTEMPLATES目录，然后到AllItem页面修改SmartQueryWebPart的LayoutControlPath属性为布局控件的虚拟路径，
如 ~/_CONTROLTEMPLATES/CodeArt_ExampleQueryLayout.ascx



下载 dll： http://files.cnblogs.com/jianyi0115/SmartQuery_v1.0.zip

另：SmartQueryWebPart的实现方式可以参考：
WSS3.0开发-过滤列表内容（1）