客户端对象、值对象和标量属性

上次修改时间: 2010年7月15日

适用范围: SharePoint Foundation 2010

在 SharePoint Online 中提供

客户端对象是从 ClientObject 类(JavaScript:ClientObject)继承的任何对象。若要访问 SharePoint Foundation 对象模型,您可以返回通过 ClientContext 类(JavaScript:ClientContext)的 Site(JavaScript:site)或 Web(JavaScript:web)属性表示网站集或网站的客户端对象。然后,您可以使用这些对象通过对象属性或方法返回其他客户端对象。例如,Web 类(JavaScript:Web)的Lists 属性(JavaScript:lists)返回网站中的列表,或者 List 类(JavaScript:List)的 GetItems(CamlQuery) 方法(JavaScript:getItems(query))返回列表中的项。当您使用这些成员返回对象时,客户端对象没有数据,直到您对对象执行数据检索以获取其关联数据。有关数据检索的信息,请参阅数据检索概述

值对象

值对象是从 ClientValueObject 类(JavaScript:ClientValueObject)类继承的任何对象。例如,ListItem(JavaScript:ListItem)是客户端对象,而 FieldUrlValue(JavaScript:FieldUrlValue)和其他字段值对象是值对象。您可能将值对象视为值封送的 .NET 类或结构,而客户端对象是引用封送的类或结构。值对象具有属性,但没有方法。SharePoint Foundation 将所有基元类型(例如 string 或 int)视为值对象。

标量属性

在对象属性返回客户端对象时,值属性返回与客户端对象相关联的属性值。例如,Title(JavaScript:title)是包含字符串或标量值的值属性,而 RootFolder(JavaScript:rootFolder)是返回文件夹的对象属性。标量属性是包含一种 .NET 值类型并且包括从 ClientValueObject(JavaScript:ClientValueObject)派生的任何类的任何属性。下面是标量属性列表。

  • bool

  • bool[]

  • byte

  • byte[]

  • char

  • char[]

  • DateTime

  • DateTime[]

  • double

  • double[]

  • enum

  • enum[]

  • float

  • float[]

  • Guid

  • Guid[]

  • int

  • int[]

  • Int16

  • Int16 []

  • Int64

  • Int64 []

  • string

  • string[]

  • UInt16

  • UInt16 []

  • UInt32

  • UInt32 []

  • UInt64

  • UInt64 []

请参阅

概念

对象模型层次结构和标识

作为中心对象的客户端上下文

创建客户端对象

客户端对象模型准则

托管对象模型和 ECMAScript 对象模型的区别

常见编程任务

其他资源

客户端类库

ECMAScript 类库

使用 SharePoint Foundation 2010 托管客户端对象模型

客户端对象模型资源中心(该链接可能指向英文页面)