代码改变世界

使用SharePoint Client OM来查询列表的注意事项

2010-11-02 16:01 by Windie Chai, ... 阅读, ... 评论, 收藏, 编辑

SharePoint 2010增加了一组新的API,叫做Client Object Model。Client OM使得我们可以为SharePoint创建客户端应用,从而避免以前在服务器端部署解决方案所带来的种种不便和安全隐患。

Client OM的出现使我们能为SharePoint构建的应用变得更加丰富,我们可以使用托管代码来创建Windows Form应用程序,也可以使用JavaScript来编写Web应用程序,还可以使用Silverlight技术来设计更加绚烂的应用。

在使用Client OM查询列表时,有一些小细节需要注意。下面这段代码演示了如何使用Client OM来查询列表:

 

ClientContext context = new ClientContext("http://localhost"); 
List list = context.Web.Lists.GetByTitle("TestList");
CamlQuery query = new CamlQuery();
query.ViewXml = string.Format("<View><ViewFields><FieldRef Name='Entity_SysCode'/></ViewFields><Query><Where><Eq><FieldRef Name='_x822a__x73ed_'/><Value Type='Text'>{0}</Value></Eq></Where></Query></View>", "CA1143");
ListItemCollection listItems = list.GetItems(query);
context.Load(listItems,
    items => items.Include(subItem => subItem["Entity_SysCode"]));
context.ExecuteQuery();

 

需要注意的是代码中需要两次指定结果集里需要包含的字段,第一次是在为CamlQuery.ViewXml指定查询语句时,必须要在ViewFields节点中指定字段。第二次是在调用ClientContext.Load时,必须再一次指定结果集里需要包含的字段。此二者缺一不可,否则会抛出“给定关键字不在字典中”的异常。

此外,ClientContext.Load方法的第二个参数是一个Lambda表达式,表达式中调用了Include方法(ClientObjectQueryableExtension.Include<TSource>),这个方法是一个扩展方法,位于Microsoft.SharePoint.Client命名空间中,我遇到的很奇怪的现象是如果在引用此命名空间时使用了别名(如下面的引用方式),那么就找不到这个Include方法,不知道算谁的bug。

 

using Client = Microsoft.SharePoint.Client;

 

最后,推荐一篇介绍Client OM的技术文章,来自MSDN:《使用 SharePoint Foundation 2010 托管客户端对象模型