随笔 - 170  文章 - 1 评论 - 2374 trackbacks - 136

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

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

使用步骤:
----------------------------------------------------------------------

1)首先下载:http://files.cnblogs.com/jianyi0115/SmartQuery_v1.0.zip 并解压。

最新发布:http://camlquery.codeplex.com/ 


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 部件   页面,添加

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)

附:

发布所有源码了,到此下载:

http://camlquery.codeplex.com/SourceControl/ListDownloadableCommits.aspx

[注意:源码是跟SmartQuery放在一起的,算是SmartQuery类库的一个应用把]



posted on 2008-02-15 20:42 jianyi 阅读(...) 评论(...) 编辑 收藏