对象模型层次结构和标识
上次修改时间: 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 |
|
N/A |
|
N/A |
|
N/A |
|
N/A |
|
N/A |
|
下表显示了新 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)) 的调用之间保留对象标识路径,因此,如果在一个调用中创建对象,则客户端将在同一上下文的后续调用中使用相同的对象路径。
备注
单独的上下文不支持对象标识功能。
请参阅
概念
其他资源
使用 SharePoint Foundation 2010 托管客户端对象模型