文档章节

SharePoint CAML In Action——Part I

 木宛城主
发布于 2015/03/02 19:41
字数 913
阅读 5
收藏 0

 

在SharePoint中,我们经常要对List进行操作,比如要从List中取出相应的ListItem,利用CAML是个好办法。在没了解CAML之前,我是这样取数据的:

MyList.Items.Cast<SPListItem>().ToList().Where(Condition).Select(Fields);

原谅我当初如此放荡不羁的写法吧。

  • 好了,现在进入CAML实战中,首先CAML (Collaborative Application Markup Language)基于XML的一种语言。所以你写CAML时一定要注意Tag是否闭合,另外CAML也是区分大小写的。

正巧在看蝙蝠侠,可以将SPList对象可以看成是银行,SPListItem对象可那么以看成银行库里一排排保险柜,SPListItem的Fields就代表每一个保险柜中的存放的财富(比如黄金、钻石、美元)。所以可以把CAML比作型号各式的子弹的话,那SharePoint SPQuery对象就是蝙蝠侠中的小丑,在抢银行之前必须把子弹上膛,对,SPQuery对象的Query属性就是一把可以匹配任何子弹万能武器,ViewFields就是你要抢的财富类型(黄金、钻石、美元),RowLimit就是抢得一定数量的财富就跑路了,而返回的SPListItemCollection集合就是抢到的财富。

是不是感到很晕,没事,先有个概念即可。我以一个简单入门的例子,你就会明白了,当然我的比喻也是即兴发挥的,有不妥也别见怪。

CAML In Action

首先我准备两个List,一个Employee,一个Specialization,为我们提供测试数据,其中Employee中的Specialization列是查阅项类型,引用了Specialization List的数据。

  • Employee

  • Specializaion

现在如果想在Employee List中取出Specialization包括CSS,并且Age大于20岁,并且还是女性的Employees

这时你脑海中的逻辑表达式为:Specialization=CSS And Age>20 And IsMale=False。

接着你需要把上述的逻辑表达式转换为CAML语言,如下:

任何给定的And元素只能有2个结合体,即只能由2个字元素,如果需要结合3个或者更多的And条件,则必须以一个条件的形式嵌套在父And中,依次类推下去。

  • 当查询时,免不了要对结果进行排序等,这时OrderBy就可用上,比如我要对上述结果进行以Age降序形式排序,则CAML:
<OrderBy>
   <FieldRef Name='Age' Ascending ='False'/>
</OrderBy>
  • 所以完整的查询部分CAML如下:
<Where> 
        <And>
             <And>
                 <Eq>
                      <FieldRef Name='Specialization'/>
                      <Value Type='Lookup'>CSS</Value>
                 </Eq> 
                 <Gt>
                      <FieldRef Name='Age'/>
                      <Value Type='Number'>20</Value>
                 </Gt>
             </And>
             <Eq>
                 <FieldRef Name='IsMale'/>
                 <Value Type='Integer'>0</Value>
             </Eq>
        </And>
 </Where>
 <OrderBy>
        <FieldRef Name='Age' Ascending ='False'/>
 </OrderBy>
  • 当然,你可以指定从查询中返回的Fields,SPQuery对象的ViewFields属性就是代表从查询中返回的Fields:
query.ViewFields = "<FieldRef Name='Title'/><FieldRef Name='Age'/>";
  • 当数据量过多时,也可以限制返回的行数:
query.RowLimit = 1000;
  • 所以完整的利用CAML进行查询的代码如下:
SPList spList = spWeb.Lists.TryGetList("Employee");
   if (spList != null)
    {
       SPQuery query = new SPQuery();
       query.Query = @"  
                      <Where> 
                        <And>
                          <And>
                            <Eq>
                                <FieldRef Name='Specialization'/>
                                <Value Type='Lookup'>CSS</Value>
                             </Eq> 
                             <Gt>
                                <FieldRef Name='Age'/>
                                <Value Type='Number'>20</Value>
                             </Gt>
                          </And>
                          <Eq>
                             <FieldRef Name='IsMale'/>
                             <Value Type='Integer'>0</Value>
                          </Eq>
                       </And>
                      </Where>
                      <OrderBy>
                       <FieldRef Name='Age' Ascending ='False'/>
                      </OrderBy> ";
 query.ViewFields = "<FieldRef Name='Title'/><FieldRef Name='Age'/>"; query.RowLimit = 10; var listItemsColl = spList.GetItems(query);

 

  • 最后感兴趣的朋友可以通过调试看一下最终生成的CAML:以View开头,而我们写的查询条件被包含在Query节点下:

接下来

这篇博客没有过多的去讲什么是CAML以及CAML的查询元素,而是以一个Example展示了如何用CAML从List中获取相应的ListItemCollection,接下来的一篇博客会对CAML语法进行一个快速参考。

 

© 著作权归作者所有

共有 人打赏支持
粉丝 2
博文 222
码字总数 199010
作品 0
黄浦
SharePoint 2013常用开发工具分享

众所周知,一款好的开发工具不仅能提高项目开发效率,而且能够协助开发人员简化开发流程。本文汇总几款SharePoint 2013开发常用开发工具,希望能够对大家有所帮助。如果您有更好的工具,没有...

冷秋寒
06/29
0
0
SharePoint中CAML使用的一些总结

协作应用程序标记语言 (CAML) 是一种基于 XML 的语言,用于在 Windows SharePoint Services 中定义在网站和列表中使用的字段和视图。CAML 还用于在网站设置过程中定义 Windows SharePoint S...

科技小毛
2017/08/08
0
0
Visual Studio 11开发指南(3)Visual Studio 11开发SharePoint 2011程序

Visual Studio 11 Developer Preview版本在几个月之前就发布了出来,通过这个预览版,SharePoint开发人员可以了解Visual Studio 11中内置的有关SharePoint开发的新功能。Visual Studio 11内置...

junwong
2012/03/09
0
0
福昕阅读器被微软指定为RMS首选PDF阅读器

近日,福昕PDF阅读器(Foxit Reader)被微软指定为AD RMS 2.0、SharePoint® 2013及SharePoint Online在Office 365环境中的首选PDF阅读器. 福昕软件开发的福昕阅读器和福昕PDF电子文档处理套...

harp
2012/11/23
373
0
Office 2010 SP1新增功能一览

日前,微软已经宣布Officer 2010 SP1将于6月底发布。届时用户可以通过微软下载中心下载或者通过更新手动升级SP1,根据以往经验,微软自动推送升级可能要到在3个月内。Office 2010 SP1将包括大...

Midnight
2011/05/23
479
2

没有更多内容

加载失败,请刷新页面

加载更多

Java中的移位运算符

国庆给自己放了个小长期二十几天,回来继续更新专栏 上一篇文章我们说了Java里的二进制,知道了计算机是以0和1来处理数据的,在阅读源码的过程中,经常会看到这些符号<< ,>>,>>>,这些符号...

SuShine
22分钟前
2
0
linux版QQ

下载地址在这 http://yun.tzmm.com.cn/index.php/s/XRbfi6aOIjv5gwj Appimage包不用做什么别的处理,安装啥的都不需要。。找到文件所在目录,终端中修改一下文件的权限 chmod 777 QQ-2017112...

悲催的古灵武士
27分钟前
1
0
咕泡-MyBatis 实用篇作业

1. Mapper在spring管理下其实是单例,为什么可以是一个单例? 首先,mapper 内部不包含 成员字段,无状态单例是安全的 另外,一直存在不用每次调用都new 一个新实例 2. MyBatis在Spring集成下...

职业搬砖20年
30分钟前
2
0
MQTT协议的初浅认识之连接建立

MQTT百科 MQTT(消息队列遥测传输)是ISO 标准(ISO/IEC PRF 20922)下基于发布/订阅范式的消息协议。它工作在 TCP/IP协议族上,是为硬件性能低下的远程设备以及网络状况糟糕的情况下而设计的发布...

亚林瓜子
47分钟前
1
0
OpenStack部署都有哪些方式

对于每一个刚接触到OpenStack的新人而言,安装无疑是最困难的,同时这也客观上提高了大家学习OpenStack云计算的技术门槛。想一想,自己3年前网上偶然接触到OpenStack时,一头茫然,手动搭建一...

tututu_jiang
47分钟前
0
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部