对象模型层次结构和标识

项目
06/15/2015

上次修改时间： 2015年3月9日

适用范围： SharePoint Foundation 2010

Microsoft.SharePoint.Client 是用于 .NET 托管对象模型和 Silverlight 对象模型的核心命名空间，SP 是用于 ECMAScript（JavaScript、JScript）对象模型的核心命名空间。客户端对象模型及其相应的集合对象继承自 ClientObject (JavaScript: ClientObject) 和 ClientObjectCollection (JavaScript: ClientObjectCollection) 类。

除核心命名空间外，Microsoft SharePoint Foundation 2010 还提供以下命名空间：

.NET 托管和 Silverlight	JavaScript
Microsoft.SharePoint.Client.Application	N/A
N/A	SP.Application.UI
N/A	SP.Ribbon
N/A	SP.Ribbon.PageState
N/A	SP.Ribbon.TenantAdmin
N/A	SP.UI
N/A	SP.UI.ApplicationPages
Microsoft.SharePoint.Client.Utilities	SP.Utilities
Microsoft.SharePoint.Client.WebParts	SP.WebParts
Microsoft.SharePoint.Client.Workflow	SP.Workflow

下表显示了新 API 为常见 SharePoint Foundation 2010 服务器对象提供的等效对象。

服务器	.NET 托管和 Silverlight	JavaScript
Microsoft.SharePoint.SPContext	Microsoft.SharePoint.Client.ClientContext	SP.ClientContext
Microsoft.SharePoint.SPSite	Microsoft.SharePoint.Client.Site	SP.Site
Microsoft.SharePoint.SPWeb	Microsoft.SharePoint.Client.Web	SP.Web
Microsoft.SharePoint.SPList	Microsoft.SharePoint.Client.List	SP.List
Microsoft.SharePoint.SPListItem	Microsoft.SharePoint.Client.ListItem	SP.ListItem
Microsoft.SharePoint.SPField（包括主要派生类）	Microsoft.SharePoint.Client.Field	SP.Field
Microsoft.SharePoint.WebPartPages.SPLimitedWebPartManager	Microsoft.SharePoint.Client.WebParts.LimitedWebPartManager	SP.WebParts.LimitedWebPartManager

新客户端 API 不提供管理对象或范围超出网站集的对象，即服务器对象模型中的 SPSite 类。

对象标识路径

当您在某个客户端对象模型中使用 SharePoint 对象时，SharePoint Foundation 会保留对象标识，这意味着在一段时间内同一对象上可能会发生多个操作和查询。这有助于防止对象变得"过时"，并帮助确保在以后获取对象时会反映出对对象所做的更改。为实现此目的，SharePoint Foundation 会在对 ExecuteQuery() 或 ExecuteQueryAsync(ClientRequestSucceededEventHandler, ClientRequestFailedEventHandler) 方法 (JavaScript: executeQueryAsync(succeededCallback, failedCallback)) 的调用之间保留对象标识路径，因此，如果在一个调用中创建对象，则客户端将在同一上下文的后续调用中使用相同的对象路径。

备注

单独的上下文不支持对象标识功能。