客户端对象、值对象和标量属性
上次修改时间: 2010年7月15日
适用范围: SharePoint Foundation 2010
客户端对象是从 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 []
请参阅
概念
其他资源
使用 SharePoint Foundation 2010 托管客户端对象模型