Clientobjekte, Wertobjekte und skalare Eigenschaften

Artikel
09/24/2014

Letzte Änderung: Donnerstag, 15. Juli 2010

Gilt für: SharePoint Foundation 2010

Ein Clientobjekt ist ein Objekt, das von der ClientObject-Klasse (JavaScript: ClientObject) erbt. Sie können auf das SharePoint Foundation-Objektmodell zugreifen, indem Sie über die Eigenschaft Site (JavaScript: site) oder Web (JavaScript: web) der ClientContext-Klasse (JavaScript: ClientContext) ein Clientobjekt zurückgeben, das eine Websitesammlung oder Website darstellt. Diese Objekte können Sie dann verwenden, um über Objekteigenschaften oder Methoden weitere Clientobjekte zurückzugeben. Beispielsweise werden mit der Lists-Eigenschaft (JavaScript: lists) der Web-Klasse (JavaScript: Web) die Listen auf der Website zurückgegeben, und mit der GetItems(CamlQuery)-Methode (JavaScript: getItems(query)) der List-Klasse (JavaScript: List) werden die Elemente in der Liste zurückgegeben. Wenn Sie Objekte mithilfe dieser Member zurückgeben, enthalten die Clientobjekte erst dann Daten, wenn Sie einen Datenabruf für die Objekte ausgeführt haben, um die zugeordneten Daten abzurufen. Weitere Informationen zum Datenabruf finden Sie unter Übersicht über den Datenabruf.

Wertobjekte

Ein Wertobjekt ist ein Objekt, das von der ClientValueObject-Klasse (JavaScript: ClientValueObject) erbt. ListItem (JavaScript: ListItem) beispielsweise ist ein Clientobjekt, FieldUrlValue (JavaScript: FieldUrlValue) und andere Feldwertobjekte sind jedoch Wertobjekte. Sie können sich ein Wertobjekt als .NET-Klasse oder -Struktur vorstellen, die nach dem Wert gemarshallt wird, während ein Clientobjekt eine Klasse oder Struktur darstellt, die nach dem Verweis gemarshallt wird. Wertobjekte haben Eigenschaften, aber keine Methoden. In SharePoint Foundation werden alle einfachen Typen, beispielsweise string oder int, als Wertobjekte behandelt.

Skalare Eigenschaften

Während von einer Objekteigenschaft ein Clientobjekt zurückgegeben wird, werden von Werteigenschaften Eigenschaftswerte zurückgegeben, die einem Clientobjekt zugeordnet sind. Title (JavaScript: title) beispielsweise ist eine Werteigenschaft, die eine Zeichenfolge oder einen skalaren Wert enthält, während RootFolder (JavaScript: rootFolder) eine Objekteigenschaft ist, von der ein Ordner zurückgegeben wird. Eine skalare Eigenschaft ist eine Eigenschaft, die einen der .NET-Werttypen und eine beliebige von ClientValueObject (JavaScript: ClientValueObject) abgeleitete Klasse enthält. In der folgenden Liste werden skalare Eigenschaften aufgeführt.