Objets clients, objets de valeur et propriétés scalaires

Article
09/24/2014

Dernière modification : jeudi 15 juillet 2010

S’applique à : SharePoint Foundation 2010

Un objet client est tout objet héritant de la classe ClientObject (JavaScript: ClientObject). Pour accéder au modèle objet SharePoint Foundation, vous pouvez retourner un objet client qui représente une collection de sites ou un site Web via la propriété Site (JavaScript: site) ou Web (JavaScript: web) de la classe ClientContext (JavaScript: ClientContext). Vous pouvez ensuite utiliser ces objets pour retourner d’autres objets clients via les propriétés ou les méthodes d’un objet. Par exemple, la propriété Lists (JavaScript: lists) de la classe Web (JavaScript: Web) retourne les listes du site Web, ou la méthode GetItems(CamlQuery) (JavaScript: getItems(query)) de la classe List (JavaScript: List) retourne les éléments de la liste. Lorsque vous retournez des objets à l’aide de ces membres, les objets clients n’ont pas de données tant que vous n’effectuez pas de récupération des données sur les objets pour obtenir les données qui y sont associées. Pour des informations sur la récupération de données, voir Vue d'ensemble de la récupération des données.

Objets de valeur

Un objet de valeur est tout objet héritant de la classe ClientValueObject (JavaScript: ClientValueObject). Par exemple, ListItem (JavaScript: ListItem) est un objet client, mais FieldUrlValue (JavaScript: FieldUrlValue) et d’autres objets de valeur de champ sont des objets de valeur. Vous pouvez considérer qu’un objet de valeur d’une classe ou d’une structure .NET est marshalé par valeur, alors qu’un objet client est une classe ou une structure qui est marshalée par référence. Les objets de valeur ont des propriétés mais n’ont pas de méthodes. SharePoint Foundation traite tous les types primitifs, tels que string ou int, en tant qu’objets de valeur.

Propriétés scalaires

Alors qu’une propriété d’objet retourne un objet client, les propriétés de valeur retournent des valeurs de propriété qui sont associées à un objet client. Par exemple, Title (JavaScript: title) est une propriété de valeur qui contient une valeur de type chaîne ou scalaire, mais RootFolder (JavaScript: rootFolder) est une propriété d’objet qui retourne un dossier. Une propriété scalaire est toute propriété contenant un des types de valeurs .NET et qui inclut toute classe dérivée de ClientValueObject (JavaScript: ClientValueObject). Voici une liste de propriétés scalaires.