在sharepoint中 使用SPSiteDataQuery来进行跨列表查询

jason0401

　　SPSiteDataQuery对象呢? 功能比较强大, sharepoint 里面还有个SPQuery对象，一个是基于列表(list)里面来查询，一个可以跨列表来查询!
　　比如，比如说! 我们现在要查询 站点下 任务列表里面 任务状态为“未完成”的! 这样我就可以知道哪些小子工作不是很卖力了哦.. (呵呵)，
　　如果用SPQuery对象呢? 就必须知道任务List，那么站点下面还有子站点呢? 子站点的任务List呢? 还要每个去找找!  像这样，我们就可以直接使用SPSiteDataQuery对象，可以查询出站点下所有状态为“未完成”的任务id，记住，他是可以跨列表的哦！
　　由于我每次使用SPSiteDataQuery呢?每次都要去学习SPSiteDataQuery对象，每次都要去google (or baidu) . 现在闲麻烦了，特此记录下来了!下面列出了参考的资料链接，当然关于SPSiteDataQuery的用户，参数说明，也是在链接里面收集下来的!
  
private void SiteDataQueryTest()
{
using (SPWeb web = new SPSite("http://dg-mlwang/").OpenWeb())
{
SPSiteDataQuery query = new SPSiteDataQuery();
query.Lists = "<Lists ServerTemplate=\"107\" />";
//query.Lists = "<Lists BaseType=\"0\" />";
//query.Lists = "<Lists Hidden = \"true\" />";
//默认只是当前web哦, 不包括子站点
query.Webs = "<Webs Scope='SiteCollection' />";
query.Query =
"<Where><Eq><FieldRef Name=\"Status\"/>" +
"<Value Type=\"Text\">未完成</Value></Eq></Where>";
//query.ViewFields = "<FieldRef Name=\"Title\" />";
DataTable items = web.GetSiteData(query);
if (items.Rows.Count > 0)
{
for (int i = 0; i < items.Rows.Count; i++)
{
string listID = items.Rows[0] + "";
SPList list = web.Lists[new Guid(listID)];
Response.Write("Title:" + list.Title + "<br />");
}
}
GridView1.DataSource = items;
GridView1.DataBind();
//修改上传新文档显示 New 标示符 的天数
//web.Site.WebApplication.DaysToShowNewIndicator = 1;
}
}　　query.webs：

　　此元素的属性只有一个：Scope。能赋予它的值有3个吧，尽管MSDN上说只有2个…..
　　① "<Webs Scope='SiteCollection' />"，包含当前网站所在的网站集(Site)下所有网站(Web)以及子网站(Web)
　　② "<Webs Scope='Recursive' />"，包含当前网站(Web)以及其下的所有子网站(Web)
　　③ 缺省，仅仅包含当前网站(Web)　　
　　query.lists:

　　此元素将定义你在文档库(Document Libraries)或者列表(Lists)里的搜索范围。
属性有4个：BaseType、ServerTemplate、Hidden、MaxListLimit
此外，子元素有两个：List、WithIndex。使用子元素可以将搜索条件限制在比较小的范围之内。
下面是关于属性的介绍。
　　① BaseType (例："<Lists BaseType='1'/>")
　　必须要注意的是这个属性的默认值为"<Lists BaseType='0'/>",也就是说缺省或者该属性设置出错时会查询文档库以外的所有列表。
　　② ServerTemplate (例： "<Lists ServerTemplate='850'/>")搜索指定类型的列表（850为页面库列表类型）。这个属性的值出错时会以默认值进行查询。
　　③ Hidden (例："<Lists ServerTemplate='850' Hidden='TRUE'/>")
设定能否搜索隐藏列表。默认是搜索所有非隐藏的列表。
　　④ MaxListLimit(例："<Lists BaseType='1' MaxListsLimit='500'/>")
定义搜索的列表的总数，当超过这个数字时，SPSiteDataQuery会抛出一个SPException的例外。这个属性的默认值为1000。当把此属性设置为0时，那么搜索的列表数目将不会受到限制。
　　query.ViewFields:
　　此元素定义返回哪些Fields（列表的列）也就是说定义了作为搜索结果的DataTable将包含哪些列（Column）。比如：
<ViewFields>
　　<FieldRef Name="Title" Nullable="TRUE" />
　　</ViewFields>
　　① Name (例：<FieldRef Name="Title" />)
　　② Nullable (例：<FieldRef Name="Title" Nullable="TRUE" />)。
　　Nullable属性为可选项。我们知道在MOSS里并不是所有的列表都包含了相同的列。比如SPSiteDataQuery在查询一个列表时，发现ViewFields里指定的某个列在列表里并不存在，那么这个列表将被忽略。而当指定了" Nullable "为"TRUE"时则可以避免这种情况，不管有没有这个列，该类表都会被查询，只是在返回的DataTable里该列将呈现空白。　　query.Query:
　　而当指定了这里就是使用CAML语句了，可以用U2U工具直接生成CAML语句，复制过来即可！前面设置那么多，这里才是关键，因为这里设置检索数据的依据，上面代码中检索 任务状态为“未完成”的列表和列表项
　　query.RowLimit
　　设置返回结果数,query.RowLimit = 10; 设置只返回10行数据
　　
　　BaseType   可填下列值

值	范围	备注
0	Generic list
1	Document library
3	Discussion forum
4	Vote or Survey
5	Issues list

　　
　　ServerTemplate 可填下列值

　　如何确定ServerTemplate的值。
　　1. 在 WSS3.0 的 SDK 的 Lists 属性主题里，你可以找到可用列表的一系列类型。
　　2. 查找feature文件下相应List的模板文件，查看Type属性的值。
例如通过下面的文件，就可以查看Announcements list的ServerTemplate为104：
（C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES\AnnouncementsList\ListTemplates\Announcements.xml）　　3  参考: http://egrimmett.wordpress.com/2008/04/01/servertemplate-numbers/
　　




100
Generic list

101
Document library

102
Survey

103
Links list

104
Announcements list

105
Contacts list

106
Events list

107
Tasks list

108
Discussion board

109
Picture library

110
Data sources

111
Site template gallery

112
User Information list

113
Web Part gallery

114
List template gallery

115
XML Form library

116
Master pages gallery

117
No-Code Workflows

118
Custom Workflow Process

119
Wiki Page library

120
Custom grid for a list

130
Data Connection library

140
Workflow History

150
Gantt Tasks list

200
Meeting Series list

201
Meeting Agenda list

202
Meeting Attendees list

204
Meeting Decisions list

207
Meeting Objectives list

210
Meeting text box

211
Meeting Things To Bring list

212
Meeting Workspace Pages list

300
Portal Sites list

301
Blog Posts list

302
Blog Comments list

303
Blog Categories list

850
Page Library

1100
Issue tracking

1200
Administrator tasks list

2002
Personal document library

2003
Private document library
　　
　　英文资料:http://blog.thekid.me.uk/archive/2007/02/27/spsitedataquery-samples-for-wss-v3.aspx
　　中文参考:http://www.cnblogs.com/Kenr/archive/2009/06/02/1494260.html
　　关于更多 SPSiteDataQuery 介绍请查阅MSDN ：http://msdn.microsoft.com/zh-cn/library/microsoft.sharepoint.spsitedataquery.aspx
　　


Technorati 标签: moss,SPSiteDataQuery,ServerTemplate,BaseType