SharePoint 列表多表联合查询实例教程

SharePoint 2023-01-12

在SharePoint的企业应用中，遇到复杂的逻辑的时候，我们会需要多表查询；SharePoint和Sql数据表一样，也支持多表联合查询，但是不像Sql语句那样简单，需要使用SPQuery的Joins属性来完成。

　　下面，我们通过一个简单的例子，为大家演示一下如何使用SPQuery通过查阅项字段来进行两个列表的联合查询。

　　1、首先创建测试列表，City是城市，然后有一个列表叫做Address，是地址，通过查阅项Location进行关联，CityID字段是Number类型，这里代表城市的ID号；

　　创建列表完毕以后，输入一些简单的测试数据，如下图：

clip_image001

　　2、测试列表Address，添加一个查阅项字段，特别要说的是，截图勾选了Title，后来因为查阅项关联的就是Title，我就去掉了，希望不要对后来造成误会，如下图：

clip_image002

　　3、查看创建完毕列表的所有栏，如下图：

clip_image003

　　4、看着Location:CityID这样的名称不是很舒服，索性点进去，改名，如下图：

clip_image004

　　5、如下图，便是我们创建完毕的测试列表，包含简单的测试数据：

clip_image005

　　6、创建一个控制台程序，引用Microsoft.SharePoint.dll，编写测试代码，因为控制台程序的创建过程非常简单，这里只贴了核心代码，如下：

 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、执行控制台程序，下面是查询的结果，如下图：

　　到这里，大家可能会有疑问，这样的查询，和列表的查询是一样的，怎么叫做多列表联合查询呢？下面请继续，听我慢慢道来；

clip_image006

　　8、我们在列表City里多添加一列，名称暂且叫做Mark，但是不将其作为查阅项关联到Address列表，如下图：

clip_image007

　　Address列表所有栏属性，并不包含Mark，如下图：

clip_image008

　　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字段，也被查询出来了，也就是我们说的多表联合查询，如下图：

clip_image009

总结

　　以上内容，就是本文的全部内容，SharePoint多表查询，通过查阅项字段进行关联，然后使用SPQuery的Joins属性进行关联查询，通过设置关联的字段和需要显示的字段来设置显示，完成关联查询。

　　本例是使用列表City和Address进行关联查询，查询Address列表通过查阅项关联查询City列表；列表结构附后，好了，就到这里吧，希望本文能够带给需要的人以帮助，谢谢！

附：列表结构

　　列表一：City

　　字段：Title（默认字段，单行文本，作为Address关联的查阅项）

　　　　　CityID（数字类型，作为Address关联的查阅项）

　　　　　Mark（单行文本，作为多表查询的测试字段）

　　列表二：Address

　　字段：Title（默认）

　　　　　Location（查阅项，关联City列表的Title）

　　　　　CustomCityID（查阅项，关联City列表的CityID）

上一篇：SharePoint 中关于event receivers的讨论及实例教程下一篇：SharePoint 跨网站集发布功能简介及实例教程

SharePoint 列表多表联合查询实例教程

热门文章

最新文章

标签列表

SharePoint 列表多表联合查询 实例教程

热门文章

最新文章

标签列表

SharePoint 列表多表联合查询实例教程