Objektmodellhierarchie und Objektidentität
Letzte Änderung: Mittwoch, 22. Juni 2011
Gilt für: SharePoint Foundation 2010
Verfügbar in SharePoint Online
Microsoft.SharePoint.Client ist der zentrale Namespace, der für das verwaltete .NET-Objektmodell und das Silverlight-Objektmodell verwendet wird. SP ist der zentrale Namespace für das ECMAScript (JavaScript, JScript)-Objektmodell. Clientobjekte und deren jeweilige Auflistungsobjekte erben von der ClientObject-Klasse (JavaScript: ClientObject) und von der ClientObjectCollection-Klasse (JavaScript: ClientObjectCollection).
Zusätzlich zum zentralen Namespace werden in Microsoft SharePoint Foundation 2010 die folgenden Namespaces bereitgestellt:
Verwaltetes .NET-Objektmodell und Silverlight-Objektmodell |
JavaScript |
---|---|
Microsoft.SharePoint.Client.Application |
Nicht zutreffend |
Nicht zutreffend |
|
Nicht zutreffend |
|
Nicht zutreffend |
|
Nicht zutreffend |
|
Nicht zutreffend |
|
Nicht zutreffend |
|
Die folgende Tabelle zeigt die entsprechenden Objekte, die in den neuen APIs für gängige SharePoint Foundation 2010-Serverobjekte bereitgestellt werden.
Serverobjektmodell |
Verwaltetes .NET-Objektmodell und Silverlight-Objektmodell |
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 (einschl. wichtige abgeleitete Klassen) |
Microsoft.SharePoint.Client.Field |
SP.Field |
Microsoft.SharePoint.WebPartPages.SPLimitedWebPartManager |
Microsoft.SharePoint.Client.WebParts.LimitedWebPartManager |
SP.WebParts.LimitedWebPartManager |
Die neuen Client-APIs stellen keine Administrationsobjekte oder Objekte bereit, die einen größeren Bereich haben als die [sitecollection]: SPSite-Klasse im Serverobjektmodell.
Objektidentitätspfad
Wenn Sie mit SharePoint-Objekten in einem der Clientobjektmodelle arbeiten, behält SharePoint Foundation die Objektidentität bei. Das bedeutet, dass im Laufe der Zeit viele Vorgänge und Abfragen mit dem gleichen Objekt ausgeführt werden können. Dadurch wird verhindert, dass Objekte "veraltet" sind, und sichergestellt, dass Änderungen an Objekten wiedergegeben werden, wenn diese nach dem Durchführen von Änderungen abgerufen werden. Dazu wird in SharePoint Foundation zwischen Aufrufen der ExecuteQuery()-Methode oder der ExecuteQueryAsync(ClientRequestSucceededEventHandler, ClientRequestFailedEventHandler)-Methode (JavaScript: executeQueryAsync(succeededCallback, failedCallback)) ein Objektidentitätspfad beibehalten. Dies bewirkt Folgendes: Wird ein Objekt in einem Aufruf erstellt, verwendet der Client den gleichen Objektpfad in nachfolgenden Aufrufen innerhalb des gleichen Kontexts.
Hinweis |
---|
Separate Kontexte unterstützen Objektidentität nicht als Feature. |
Siehe auch
Konzepte
Clientkontext als zentrales Objekt
Clientobjekte, Wertobjekte und skalare Eigenschaften
Richtlinien für das Clientobjektmodell
Unterschiede zwischen verwalteten und ECMAScript-Objektmodellen
Allgemeine Programmieraufgaben
Weitere Ressourcen
Verwenden des verwalteten Clientobjektmodells von SharePoint Foundation 2010