在SharePoint的企业应用中,遇到复杂的逻辑的时候,我们会须要多表查询;SharePoint和Sql数据表一样,也支持多表联合查询,可是不像Sql语句那样简单,须要使用SPQuery的Joins属性来完毕。
以下。我们通过一个简单的样例,为大家演示一下怎样使用SPQuery通过查阅项字段来进行两个列表的联合查询。
1、首先创建測试列表,City是城市,然后有一个列表叫做Address,是地址,通过查阅项Location进行关联,CityID字段是Number类型,这里代表城市的ID号。
创建列表完成以后。输入一些简单的測试数据。例如以下图:
2、測试列表Address,加入一个查阅项字段,特别要说的是,截图勾选了Title,后来由于查阅项关联的就是Title。我就去掉了。希望不要对后来造成误会,例如以下图:
3、查看创建完成列表的全部栏,例如以下图:
4、看着Location:CityID这种名称不是非常舒服。索性点进去,改名。例如以下图:
5、例如以下图,便是我们创建完成的測试列表,包括简单的測试数据:
6、创建一个控制台程序。引用Microsoft.SharePoint.dll,编写測试代码。由于控制台程序的创建过程很easy。这里仅仅贴了核心代码,例如以下:
1 using (SPSite site = new SPSite(SiteUrl)) 2 { 3 using (SPWeb web = site.RootWeb) 4 { 5 SPQuery query = new SPQuery(); 6 //Joins属性,这里有INNER和LEFT两种方式连接,均可查询。并且支持多表连接; 7 query.Joins = "<Join Type='INNER' ListAlias='City'>" + 8 "<Eq>" + 9 "<FieldRef Name='Location' RefType='Id'/>" + 10 "<FieldRef List='City' Name='ID'/>" + 11 "</Eq>" + 12 "</Join>"; 13 //设置关联的查阅项字段 14 query.ProjectedFields = "<Field Name='CustomCityID' Type='Lookup' " + 15 "List='City' ShowField='CityID'/>"; 16 //设置须要显示的字段 17 query.ViewFields = "<FieldRef Name='Title'/>" + 18 "<FieldRef Name='Location'/>" + 19 "<FieldRef Name='CustomCityID'/>"; 20 21 SPList list = web.GetList(ListName); 22 SPListItemCollection itemcoll = list.GetItems(query); 23 foreach (SPListItem item in itemcoll) 24 { 25 SPFieldLookupValue Location = new SPFieldLookupValue(item["Location"].ToString()); 26 SPFieldLookupValue CustomCityID = new SPFieldLookupValue(item["CustomCityID"].ToString()); 27 Console.WriteLine("ID:" + item.ID.ToString() + " Title:" + item["Title"].ToString() + " Location:" + Location.LookupValue + " CustomCityID:" + CustomCityID.LookupValue); 28 } 29 } 30 }
7、运行控制台程序,以下是查询的结果,例如以下图:
到这里,大家可能会有疑问,这种查询,和列表的查询是一样的。怎么叫做多列表联合查询呢?以下请继续,听我慢慢道来;
8、我们在列表City里多加入一列。名称暂且叫做Mark,可是不将其作为查阅项关联到Address列表,例如以下图:
Address列表全部栏属性,并不包括Mark,例如以下图:
9、同一时候为代码的ProjectedFields多加入Mark的字段属性,例如以下图:
query.ProjectedFields = "<Field Name='CustomCityID' Type='Lookup' List='City' ShowField='CityID'/> <Field Name='CustomMark' Type='Lookup' List='City' ShowField='Mark'/>";
10、同一时候为显示属性增加CustomMark字段,例如以下图:
query.ViewFields = "<FieldRef Name='Title'/>" + "<FieldRef Name='Location'/>" + "<FieldRef Name='CustomCityID'/>" + "<FieldRef Name='CustomMark'/>";
输出加入CustomMark字段的值,例如以下:
SPFieldLookupValue CustomMark = new SPFieldLookupValue(item["CustomMark"].ToString()); Console.WriteLine("CustomMark:" + CustomMark.LookupValue)
11、再次运行控制台程序,并没有以查阅项关联到Address的Mark字段,也被查询出来了,也就是我们说的多表联合查询,例如以下图:
总 结
以上内容。就是本文的所有内容,SharePoint多表查询,通过查阅项字段进行关联,然后使用SPQuery的Joins属性进行关联查询,通过设置关联的字段和须要显示的字段来设置显示,完毕关联查询。
本例是使用列表City和Address进行关联查询。查询Address列表通过查阅项关联查询City列表;列表结构附后。好了,就到这里吧,希望本文可以带给须要的人以帮助,谢谢。
附:列表结构
列表一:City
字段:Title(默认字段,单行文本,作为Address关联的查阅项)
CityID(数字类型,作为Address关联的查阅项)
Mark(单行文本,作为多表查询的測试字段)
列表二:Address
字段:Title(默认)
Location(查阅项,关联City列表的Title)
CustomCityID(查阅项。关联City列表的CityID)
附:參考链接
http://social.msdn.microsoft.com/Forums/sharepoint/zh-CN/866a49fd-0656-4a8a-9e11-36eeb4401005/sharepoint-2010-caml-list-joins
http://msdn.microsoft.com/zh-cn/library/microsoft.sharepoint.spquery.joins.aspx