SharePoint 2010新特性使用Client Object Model在客户端开发

SharePoint 2010提供了一组新的客户端API，可以让我们在客户端通过浏览器中的JavaScript 、.Net应用程序或Silverlight中与服务器进行交互，称之为客户端对象模型Client Object Model，它与之前我们使用的Server Object Model (定义在Microsoft.SharePoint.dll中) 对应，比如客户端对象模型中Site与服务器端对象模型的SPSite，Web与SPWeb等；客户端对象模型并没有定义对应所有的SharePoint Foundation对象，一是处于安全方面的考虑，还有就是减小客户端对象模型的大小，减小客户端的响应时间，这点在使用JavaScript和Silverlight开发时尤其重要。
客户端对象模型在设计上与服务器端对象模型类似，包括对象定义、对象继承、集合、异常处理等等，因此如果你有在MOSS 2007上的开发经验，对服务器端对象模型很熟悉，可以很快的学会使用客户端对象模型。先来看一下几个主要对象的对应关系：



在这篇文章中，我们先来看一下怎样在.Net应用程序中使用客户端对象模型。简单起见，我就创建一个控制台应用程序进行演示。
首先我们引用两个dll：Microsoft.SharePoint.Client和Microsoft.SharePoint.Client.Runtime。
它们在服务器C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\ISAPI路径下。既然是在客户端开发，我们把它拷贝下来。然后在项目中添加引用。

using Microsoft.SharePoint.Client;
下面这个类在使用客户端对象模型开发时非常重要: ClientContext，可以把它看做一个入口，它的定义与使用服务器端对象模型开发时定义SPSite类似：
ClientContext clientContext = new ClientContext("http://win-9smkc3gif6u")
使用客户端对象模型，首先我们要定义一个ClientContext，这个类和它的基类的SDK是小弟所写，因此若对它的属性或方法有什么疑问，我们可以一起讨论一下。

下面我们就通过几个实际的例子演示一下如何使用客户端对象模型：
从简单的开始，从客户端取得服务器端一个站点的Title：
ClientContext clientContext = new ClientContext("http://win-9smkc3gif6u");
Web web = clientContext.Web;

clientContext.Load(web);
clientContext.ExecuteQuery();
Console.WriteLine(web.Title);

解释一下这几行代码，前两行定义对象，第三行是加载web对象的属性，也就是定义第四行的要向服务器端请求哪些数据，我们这样写是把所有的全部加载进来，也可以这样写只加载web对象的Title和Created属性：
clientContext.Load(oWebsite,website => website.Title,website => website.Created);
也可以这样写，效果与上面完全一样：
ClientContext clientContext = new ClientContext("http://win-9smkc3gif6u");
Web web = clientContext.Web;

web.Retrieve(); //相当于clientContext.Load(web);
clientContext.ExecuteQuery();
Console.WriteLine(web.Title);

再来看一个例子，如何更新上面这个站点的Title：
ClientContext clientContext = new ClientContext("http://win-9smkc3gif6u");
Web web = clientContext.Web;

web.Title = "New Title";
web.Update();

clientContext.ExecuteQuery();
打开站点，发现Title已经被更新。

再来看一个，取得站点下的所有列表并输出它们的Title：
ClientContext clientContext = new ClientContext("http://win-9smkc3gif6u");
Web web = clientContext.Web;

clientContext.Load(web.Lists);
clientContext.ExecuteQuery();

foreach (List list in web.Lists)
{
Console.WriteLine(list.Title);
}
可以使用LINQ，不过，这个不是LINQ to SharePoint Provider，是LINQ to Objects:
比如，我们只取“Shared Documents”这个文档库：
ClientContext clientContext = new ClientContext("http://win-9smkc3gif6u");
Web web = clientContext.Web;

var query = from list
in clientContext.Web.Lists
where list.Title == "Shared Documents"
select list;

var result = clientContext.LoadQuery(query);
clientContext.ExecuteQuery();

foreach (List list in result)
Console.WriteLine(list.Title);
我们也可以使用lambda表达式，还是上面的例子，只取“Shared Documents”这个文档库：
ClientContext clientContext = new ClientContext("http://win-9smkc3gif6u");
Web web = clientContext.Web;
clientContext.Load(web, website => website.Lists.Include(list => list.Title).Where(list => list.Title =="Shared Documents"));

clientContext.ExecuteQuery();

foreach (List list in web.Lists)
Console.WriteLine(list.Title);
关于客户端对象模型，是一个非常大的概念，使用它在客户端开发能实现很多需求，比如创建、更新、删除站点，列表，列表里的条目item，给用户分配权限、角色、添加到用户组中，添加、更新删除页面上的Web Part，等等，基本在服务器端能做到的通过它在客户端都可以实现，抛砖引玉，希望大家深入研究一下Client Object Model，会给你带来意想不到的收获！
更多的内容，请参阅：http://msdn.microsoft.com/en-us/library/ee537247(office.14).aspx

if ($ != jQuery) {
$ = jQuery.noConflict();
}

来源：/article/5889007.html