Клиентские объекты, объекты значений и скалярные свойства

Статья
04/21/2015

Дата последнего изменения: 15 июля 2010 г.

Применимо к: SharePoint Foundation 2010

Клиентский объект — это любой объект, наследуемый от класса ClientObject (JavaScript: ClientObject). Для доступа к объектной модели SharePoint Foundation можно вернуть клиентский объект, представляющий семейство сайтов или веб-сайт, с помощью свойства Site (JavaScript: site) или Web (JavaScript: web) класса ClientContext (JavaScript: ClientContext). Затем эти объекты можно использовать для получения других клиентских объектов с помощью свойств или методов объекта. Например, свойство Lists (JavaScript: lists) класса Web (JavaScript: Web) возвращает списки веб-сайта, а метод GetItems(CamlQuery) (JavaScript: getItems(query)) класса List (JavaScript: List) возвращает элементы списка. При возврате объектов с помощью этих членов клиентские объекты не содержат данных до применения операции получения данных к объектам. Дополнительные сведения о получении данных см. в статье Обзор извлечения данных.

Объекты значений

Объект значения — это любой объект, наследуемый от класса ClientValueObject (JavaScript: ClientValueObject). Например, ListItem (JavaScript: ListItem) — это клиентский объект, но FieldUrlValue (JavaScript: FieldUrlValue) и другие объекты значения полей — это объекты значений. Объект значений можно представить как класс или структуру .NET, которые упаковываются по значению, а клиентский объект — это класс или структура, которые упаковываются по ссылке. Объекты значений содержат свойства, но не имеют методов. SharePoint Foundation обрабатывает все примитивные типы, такие как string или int, как объекты значений.

Скалярные свойства

Свойства объектов возвращают клиентский объект, а свойства значений возвращают значений свойств, связанных с клиентским объектом. Например, Title (JavaScript: title) — это свойство значения, которое содержит строку или скалярное значение, но RootFolder (JavaScript: rootFolder) — это свойство объекта, которое возвращает папку. Скалярное свойство — это свойство, которое содержит одно из типов значений .NET и включает любой класс, производный от ClientValueObject (JavaScript: ClientValueObject). Далее представлен список скалярных свойств.