Стандартный блок. Файлы и документы
Дата последнего изменения: 1 ноября 2010 г.
Применимо к: SharePoint Foundation 2010
В этой статье
Объектная модель для файлов и документов
XML-разметка, используемая для файлов и документов
Области, относящиеся к файлам и документам
Дополнительные сведения о файлах и документах
В контексте Microsoft SharePoint Foundation термин "файл" может относиться к документу, связанному с элементом списка в библиотеке документов, или к ASPX-странице сайта или приложения, содержащей пользовательский интерфейс. Дополнительные сведения о страницах сайтов и страницах приложений см. в статье Стандартный блок: страницы и пользовательский интерфейс.
Каждый документ в библиотеке документов представлен двумя объектами: SPListItem и SPFile. При возвращении элемента списка из библиотеки документов можно использовать свойство File, чтобы извлечь файл, связанный с элементом. Свойство Files класса SPFolder возвращает все файлы, находящиеся в папке библиотеки документов, а свойство Files класса SPWeb возвращает ASPX-файлы, используемые в веб-сайте. Эффективным способом возвращения конкретной папки является использование метода GetFolder() веб-сайта.
.gif "Примечание") Примечание |
|---|
Помните, что для библиотек документов, как и для общих списков, объект SPFolder считается элементом списка. Код, перечисляющий все элементы библиотеки документов, может использовать свойство FileSystemObjectType элемента списка, чтобы отличить папку от файла. |
Чтобы добавить файл в библиотеку документов, используйте один из методов Add() класса SPFileCollection. Чтобы скопировать файл из одного местоположения в другое внутри веб-сайта или между веб-сайтами, используйте метод Copy() объекта, связанного с элементом списка. Чтобы добавить не веб-сайт страницу сайта или страницу приложения, для предоставления файла используйте компонент модуля. Сведения о компонентах см. в статье Базовые элементы разработки: компоненты.
Объектная модель для файлов и документов
К самым важным классам, используемым при работе с файлами и документами в серверной и клиентской объектных моделях, относятся следующие:
SPFile — представляет файл на веб-сайте SharePoint Foundation, который может быть страницей веб-частей, элементом библиотеки документов или файлом в папке.
SPFolder — представляет папку на веб-сайте SharePoint Foundation.
Клиентская объектная модель: Folder (JavaScript: SP.Folder)
SPFileCollectionAddParameters — инкапсулирует параметры, которые можно использовать для добавления файла в коллекцию файлов с помощью метода Add(String, [], SPFileCollectionAddParameters) или Add(String, Stream, SPFileCollectionAddParameters).
SPFileSaveBinaryParameters — инкапсулирует параметры, которые можно использовать при сохранении файла с помощью вызова метода SaveBinary(Stream, SPFileSaveBinaryParameters).
Клиентская объектная модель: FileSaveBinaryInformation
SPFileStream — предоставляет объект Stream, связанный с файлом SharePoint Foundation.
SPFileVersion — представляет версию объекта файла.
Клиентская объектная модель: FileVersion (JavaScript: SP.FileVersion)
XML-разметка, используемая для файлов и документов
Элемент File языкаCAML используется внутри элемента Module для предоставления веб-сайтов со страницей сайта или приложения. Элемент File может использоваться внутри модуля в элементе Configuration определения веб-сайта для включения файла в веб-сайты, создаваемые с помощью определения веб-сайта, либо элемент File может использоваться в файле манифеста компонента. Дополнительные сведения о двух возможных способах использования этого элемента см. в статье Модули. Пример, демонстрирующий использование элемента File для предоставления веб-сайтов с файлом, см. в статье Подготовка файла.
Области, относящиеся к файлам и документам
Базовые элементы: списки и библиотеки документов
Стандартный блок: страницы и пользовательский интерфейс
Базовые элементы разработки: компоненты
Дополнительные сведения о файлах и документах
Добавление заблокированных типов файлов