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

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

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

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

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

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

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

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

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

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

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

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

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

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

SharePoint 列表多表联合查询 实例教程
 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 }
SharePoint 列表多表联合查询 实例教程

  7、执行控制台程序,下面是查询的结果,如下图:

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

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

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

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

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

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

  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 列表多表联合查询 实例教程

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

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

附:列表结构

  列表一:City

  字段:Title(默认字段,单行文本,作为Address关联的查阅项)

     CityID(数字类型,作为Address关联的查阅项)

     Mark(单行文本,作为多表查询的测试字段)

  列表二:Address

  字段:Title(默认)

     Location(查阅项,关联City列表的Title)

     CustomCityID(查阅项,关联City列表的CityID)

发表评论

您的电子邮箱地址不会被公开。 必填项已用*标注