Базовые элементы: списки и библиотеки документов

Статья
04/21/2015

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

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

В этой статье
Объектная модель для списков и библиотек документов
XML-код, используемый для списков и библиотек документов
Области, связанные со списками и библиотеками документов
Дополнительные сведения о списках и библиотеках документов

Microsoft SharePoint Foundation 2010 предоставляет несколько интерфейсов API, которые можно использовать для работы со списками. Следующие управляемые объектные модели предоставляют типы и члены, позволяющие изменять свойства списков и управлять шаблонами списков и элементами списков:

Для кода, работающего на сервере, пространство имен Microsoft.SharePoint предоставляет базовые классы, представляющие список. Пространство имен Microsoft.SharePoint.Deployment предоставляет интерфейсы API для переноса контента между семействами сайтов.
Для управляемого кода, работающего в контексте клиентских приложений Microsoft .NET 3.5 или приложений Silverlight, пространство имен Microsoft.SharePoint.Client предоставляет подмножество типов и членов, доступных в серверной объектной модели.
Для скрипта, работающего в браузере в объектной модели ECMAScript (JavaScript, JScript), пространства имен SP предоставляет подмножество типов и членов, доступных в серверной объектной модели.
Веб-служба Lists предоставляет методы для удаленной работы со списками.

Можно использовать метод SaveAsTemplate(String, String, String, Boolean) в серверной объектной модели для сохранения существующего списка SharePoint Foundation в качестве шаблона или использовать класс SPListTemplate и его класс коллекции для управления шаблонами списков. Класс SPListTemplate представляет оба настраиваемых шаблона списков, которые создаются с помощью метода SaveAsTemplate(String, String, String, Boolean) или сохраняются с помощью пользовательского интерфейса, и определения списков, которые устанавливаются и активируются в виде компонента в папке %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES.

Схема списка имеет базовый тип и тип шаблона списков. Перечисление SPBaseType определяет следующие базовые типы списков:

Общий тип списков для большинства списков
Библиотека документов
Доска обсуждений
Опрос
Проблема
Неопределенный базовый тип.

Перечисление SPListTemplateType определяет типы шаблонов списков по умолчанию в SharePoint Foundation, каждый из которых связан с одним определением базового типа списков. Класс SPList предоставляет доступ к свойствам списка, общих для всех списков, но также возможно производить типы шаблонов списков от базового типа списков. Например, можно привести объект списка, представляющий библиотеку документов, как объект SPDocumentLibrary, чтобы получить доступ к свойствам, специфичным для библиотек документов.

В составе Microsoft Microsoft Business Connectivity Services (BCS) имеются API-интерфейсы для работы с внешними списками. Дополнительные сведения о Business Connectivity Services см. в разделе Стандартный блок: внешние типы контента и внешние списки.

Объектная модель для списков и библиотек документов

Следующие классы в серверной и клиентской объектной модели могут использоваться для работы со списками, шаблонами списков и элементами списков:

Класс SPList представляет список на веб-сайте SharePoint. Эффективный способ возвратить определенный список заключается в использовании метода GetList класса SPWeb или SPListCollection.

Клиентская объектная модель: List (JavaScript: List)
Класс SPListDataSource предоставляет сведения о внешнем списке.

Клиентская объектная модель ListDataSource (JavaScript: ListDataSource)
Класс SPListEventProperties предоставляет свойства для событий списков SharePoint
Класс SPListEventReceiver предоставляет методы для перехвата происходящих событий для списков.
Класс SPListItem представляет элемент или строку в списке. Эффективный способ возвращения элемента списка или SPListItemCollection заключается в использовании метода GetItem* класса SPList или SPWeb.

Клиентская объектная модель: ListItem (JavaScript: ListItem)
Класс SPListItemVersion представляет версию элемента списка.
Класс SPListTemplate представляет определение списка или шаблон списка, который определяет поля и представления списка. Определения списка содержатся в файлах в папке %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES, но шаблоны списков создаются с помощью пользовательского интерфейса или объектной модели, когда список сохраняется в качестве шаблона.

Клиентская объектная модель: ListTemplate (JavaScript: ListTemplate)
Класс SPListTemplateType является перечислением, задающим тип определения списка или шаблона списка.

Клиентская объектная модель: ListTemplateType (JavaScript: ListTemplateType)
Класс SPBaseType является перечислением, задающим базовый тип для списка.

Клиентская объектная модель: BaseType (JavaScript: BaseType)
Класс SPDocTemplate представляет шаблон документа, используемый в библиотеке документов.
Класс SPDocumentLibrary представляет библиотеку документов в SharePoint Foundation.

Дополнительные сведения о работе со списками в серверной объектной модели см. в разделе Работа с объектами List и коллекциями, а задачи программирования включены в раздел Базовые задачи объектной модели. Дополнительные сведения о работе со списками в клиентских объектных моделях см. в разделе Обзор извлечения данных, а задачи программирования в разделе Общие задачи программирования.

XML-код, используемый для списков и библиотек документов

Определение списка активируется как компонент SharePoint Foundation, которому соответствует файл Schema.xml, содержащий схему, хотя основная часть определения представления будет доступна через XSLT в каталоге %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\XSL. Элемент List является элементом верхнего уровня в схеме списка, но элемент Configuration в схеме определения сайта также содержит элемент List для включения конкретного списка в состав веб-сайтов, создаваемых на основе определения сайта. Компонент Экземпляр списка позволяет задавать данные, которые будут использоваться по умолчанию для наполнения типа списка. Дополнительные сведения об использовании компонентов см. в разделе Использование компонентов. Пример создания компонента определения списка см. в разделе Создание настраиваемого определения списка.