在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:
  1. <OrderBy>
  2. <FieldRef Name='Age' Ascending ='False'/>
  3. </OrderBy>
  • 所以完整的查询部分CAML如下:
  1. <Where>
  2. <And>
  3. <And>
  4. <Eq>
  5. <FieldRef Name='Specialization'/>
  6. <Value Type='Lookup'>CSS</Value>
  7. </Eq>
  8. <Gt>
  9. <FieldRef Name='Age'/>
  10. <Value Type='Number'>20</Value>
  11. </Gt>
  12. </And>
  13. <Eq>
  14. <FieldRef Name='IsMale'/>
  15. <Value Type='Integer'>0</Value>
  16. </Eq>
  17. </And>
  18. </Where>
  19. <OrderBy>
  20. <FieldRef Name='Age' Ascending ='False'/>
  21. </OrderBy>
  • 当然,你可以指定从查询中返回的Fields,SPQuery对象的ViewFields属性就是代表从查询中返回的Fields:
  1. query.ViewFields = "<FieldRef Name='Title'/><FieldRef Name='Age'/>";
  • 当数据量过多时,也可以限制返回的行数:
  1. query.RowLimit = ;
  • 所以完整的利用CAML进行查询的代码如下:
  1. SPList spList = spWeb.Lists.TryGetList("Employee");
  2. if (spList != null)
  3. {
  4. SPQuery query = new SPQuery();
  5. query.Query = @"
  6. <Where>
  7. <And>
  8. <And>
  9. <Eq>
  10. <FieldRef Name='Specialization'/>
  11. <Value Type='Lookup'>CSS</Value>
  12. </Eq>
  13. <Gt>
  14. <FieldRef Name='Age'/>
  15. <Value Type='Number'>20</Value>
  16. </Gt>
  17. </And>
  18. <Eq>
  19. <FieldRef Name='IsMale'/>
  20. <Value Type='Integer'>0</Value>
  21. </Eq>
  22. </And>
  23. </Where>
  24. <OrderBy>
  25. <FieldRef Name='Age' Ascending ='False'/>
  26. </OrderBy> ";
  1. query.ViewFields = "<FieldRef Name='Title'/><FieldRef Name='Age'/>";
  2. query.RowLimit = ;
  3. var listItemsColl = spList.GetItems(query);
  • 最后感兴趣的朋友可以通过调试看一下最终生成的CAML:以View开头,而我们写的查询条件被包含在Query节点下:

接下来

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

SharePoint CAML In Action——Part I的更多相关文章

  1. SharePoint CAML In Action——Part II

    在SharePoint中,相对于Linq to SharePoint而言,CAML是轻量化的.当然缺点也是显而易见的,"Hard Code"有时会让你抓狂.在实际场景中,经常会根据 ...

  2. SHAREPOINT - CAML列表查询

    首先要了解的是CAML(Collaboration Application Markup Language)不仅仅是用在对列表.文档库的查询,字段的定义,站点定义等处处使用的都是CAML. 简单的提一 ...

  3. SharePoint 2010/SharePoint 2013 Custom Action: 基于Site Collection 滚动文字的通知.

    应用场景: 有时候我们的站点需要在每个页面实现滚动文字的通知,怎么在不修改Master Page的情况下实现这个功能?我们可以使用Javascript 和 Custom Action 来实现. 创建一 ...

  4. SharePoint CAML Query小结

    CAML的结构. <View Type="HTML" Name="Summary"> <ViewBody ExpandXML="TR ...

  5. Overcoming the List View Threshold in SharePoint CAML queries

    From: https://www.codeproject.com/articles/1076854/overcoming-the-list-view-threshold-in-sharepoint- ...

  6. SharePoint - CAML

    1. CAML是顺序操作,如果要实现类似 “A or B or C or D” 的结果,最好写成 “(((A or B) or C) or D)”的形式,但写成 “((A or B) or (C or ...

  7. Sharepoint CAML 增删改查 List

    Lists.UpdateListItems 方法 (websvcLists) Windows SharePoint Services 3   Adds, deletes, or updates the ...

  8. 深入浅出SharePoint——Caml快速开发

    适用于Visual Studio 2010的Caml智能感知工具 http://visualstudiogallery.msdn.microsoft.com/15055544-fda0-42db-a6 ...

  9. [总结]SHAREPOINT - CAML列表查询(上)

    首先要了解的是CAML(Collaboration Application Markup Language)不仅仅是用在对列表.文档库的查询,字段的定义,站点定义等处处使用的都是CAML. 简单的提一 ...

随机推荐

  1. C#.NET常见问题(FAQ)-如何使用右下角托盘图标notifyIcon

    1 拖放一个NotifyIcon控件,并设置图标,还有显示的文字   2 双击这个控件,即当最小化了主窗体,然后双击这个右下角图标的时候,要显示主窗体(大部分程序的用户体验都是这样干的,比如QQ,双击 ...

  2. js 时间加减

    //js格式化时间 "yyyy-MM-dd hh:mm:ss" Date.prototype.Format = function (fmt) { var o = { "M ...

  3. VS2015 之 多行缩进

        VS2015工具栏缺少“多行缩进工具”,经查阅资料总结如下:     首先,选中需要缩进的行代码:     1.增大缩进:“Tab”键     2.减小缩进:“Shift”键 + “Tab”键

  4. 高级NUMA参数

    Advanced NUMA Attributes You can use the advanced NUMA attributes to customize NUMA usage. Attribute ...

  5. Linux下使用Supervisor来管理维护程序-详解

    一.场景 常常需要后台支行一个进程,或者开机自动运行等等. 首先,后台运行可以考虑使用nohup和&来实现,想实现开机运行,可以把命令写到/etc/rc.d/rc.local中. 但是,上面这 ...

  6. winf

    真的,先亮注册码!!(直接复制即可) 注册码: <第1组> 用户名:大眼仔~旭(Anan) 注册码:01000000007002140V <第2组> 用户名:大眼仔~旭(Ana ...

  7. MySQL 批量杀mysql线程

    mysql> SELECT concat('KILL ',id,';') FROM information_schema.processlist WHERE user='root'; +---- ...

  8. 解决 Out of range value adjusted for column 'ID' at row 1

    MySQL升级到5.0.17后,在执行sql语句INSERT INTO `news` (`ID`, `Title`, `Content`) VALUES ('', '标题', '正文');时出现错误: ...

  9. WINDOWS7 下 xclient 802.1x 客户端 停止运行的解决办法

    昨天下午,由于FOXMAIL 出现问题,修改了一个地方,导致xclient 停止运行.具体解决办法如下:右击“计算机”-进入“系统属性”-->“高级”-->"设置"-- ...

  10. JavaBean与XML转换——XStream使用笔记

    转载请注明原文地址:http://www.cnblogs.com/ygj0930/p/6648131.html  一:View层与Control层的数据交互 做过Web项目的人都知道,当对一个requ ...