(一)概述
在SharePoint的开发应用中,查询是非常常用的一种手段,根据某些筛选、排序条件,获得某个列表或者某一些列表中相应的列表条目的集合。
除去列表上的查询之外,在SharePoint中还大量存在着各种各样的查询,比如针对回收站的SPRecycleBinQuery、针对审计的SPAuditQuery、针对变更的SPChangeQuery等等,不过这些查询在实际项目中使用到的频率并不是很高。本章节还是着重介绍列表查询功能。
在SharePoint 2010之前,列表查询的查询语句都是通过CAML这样一种XML格式来编写的。对于开发人员来讲,准确快速地编写出较为复杂的CAML查询并非是一件轻而易举的事情,但是使用CAML进行数据查询仍是SharePoint开发中不可或缺的技能。本节将介绍如何使用CAML进行列表查询和跨多个列表之间的查询,在下一节中将介绍SharePoint 2010新引入的列表查询方式——LINQ。
(二)CAML查询字符串
在列表查询中,所有的查询条件都要使用一种Xml形式的语法进行描述,这种Xml语法被称作CAML(Collaborative Application Markup Language),是SharePoint中一种特定的Xml语法。实际上,在SharePoint中不仅是列表查询使用了CAML,在网站、列表、字段、内容类型、网站功能等各种对象的定义中,也大量使用了CAML格式的Xml。
CAML查询字符串总的来说可以分为3大部分:筛选条件、排序和分组条件、返回字段。
在编写CAML字符串的时候,需要特别注意Xml标签的大小写是敏感的。
1、筛选条件
使用CAML格式的筛选条件可以理解为是将传统的数据库中的SELECT语句以Xml的形式进行标准化,便于计算机的解析和阅读。
CAML格式的筛选条件使用<Where></Where>作为最外层结点,标志筛选条件的范围。筛选条件可以由若干个子筛选条件组成,每个子筛选条件的格式都类似于:
<操作符><字段/><值/></操作符> 相当于: [字段] [操作符] [值]
其中操作符部分一般应用中包括:Eq(等于)、Neq(不等于)、Lt(小于)、Leq(小于等于)、Gt(大于)、Geq(大于等于)、Contains(包含)、BeginsWith(以某字符串开头)、In(在集合范围内)、IsNull(为空)、IsNotNull(不为空)、Membership(属于用户组)。最后三个操作符是一元操作符,没有其中的“值”的部分。
字段部分的格式为:<FieldRef Name="字段名" 其他属性 />,特别注意不要遗忘最后的“/”终结符,字段名必须使用内部名称。
值部分的格式为:<Value Type="类型">值</Value>,其中类型部分根据不同的字段有不同的设置,常用的包括Text(文本)、Number(数值)、DateTime(日期)、Lookup(查阅项)等等。
例如,我们要在列表中查询“标题”字段(内部名称为Title)包含字符串“对象模型”的那些列表条目,如果是传统的T-SQL语句写法,应该是形如: