Jerarquía e identidad del modelo de objetos

Artículo
09/24/2014

Última modificación: miércoles, 22 de junio de 2011

Hace referencia a: SharePoint Foundation 2010

Microsoft.SharePoint.Client es el espacio de nombres básico que se usa para los modelos de objetos administrados .Net y Silverlight, y SP es el espacio de nombres básico para el modelo de objetos de ECMAScript (JavaScript, JScript). Los objetos de cliente y sus respectivos objetos de colección heredan de las clases ClientObject (JavaScript: ClientObject) y ClientObjectCollection (JavaScript: ClientObjectCollection).

Además del nombre de espacio básico, Microsoft SharePoint Foundation 2010 proporciona los siguientes espacios de nombres:

Administrados .NET y Silverlight	JavaScript
Microsoft.SharePoint.Client.Application	N/D
N/D	SP.Application.UI
N/D	SP.Ribbon
N/D	SP.Ribbon.PageState
N/D	SP.Ribbon.TenantAdmin
N/D	SP.UI
N/D	SP.UI.ApplicationPages
Microsoft.SharePoint.Client.Utilities	SP.Utilities
Microsoft.SharePoint.Client.WebParts	SP.WebParts
Microsoft.SharePoint.Client.Workflow	SP.Workflow

En la siguiente tabla se muestran los objetos equivalentes que las nuevas API proporcionan para los objetos de servidor comunes de SharePoint Foundation 2010.

Servidor	Administrados .NET y 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 (incluidas las clases principales derivadas)	Microsoft.SharePoint.Client.Field	SP.Field
Microsoft.SharePoint.WebPartPages.SPLimitedWebPartManager	Microsoft.SharePoint.Client.WebParts.LimitedWebPartManager	SP.WebParts.LimitedWebPartManager

Las nuevas API de cliente no proporcionan objetos de administración ni objetos que tengan un ámbito superior a esta colección de sitios: clase SPSite en el modelo de objetos de servidor.

Ruta de identidad del objeto

Cuando trabaja con objetos de SharePoint en uno de los modelos de objetos de cliente, SharePoint Foundation retiene la identidad del objeto, lo que significa que varias operaciones y consultas pueden ocurrir con el mismo objeto a lo largo del tiempo. Esto ayuda a evitar que los objetos se vuelvan "obsoletos" y a asegurar que los cambios en los objetos se reflejen cuando se obtiene el objeto posteriormente. Con este fin, SharePoint Foundation mantiene una ruta de identidad del objeto entre llamadas a los métodos ExecuteQuery() o ExecuteQueryAsync(ClientRequestSucceededEventHandler, ClientRequestFailedEventHandler) (JavaScript: executeQueryAsync(succeededCallback, failedCallback)), de modo que si se crea un objeto en una llamada, el cliente usará la misma ruta del objeto en llamadas posteriores dentro del mismo contexto.

Nota

Contextos separados no admiten la característica de identidad del objeto.