Поделиться через


Использование модулей для включения файлов в решение

Вам может потребоваться развернуть файлы на сервере SharePoint независимо от их типа, например новые эталонные страницы. Для этого можно использовать модули (не путать с модулями кода Visual Basic). Модули — это контейнеры для файлов в решении SharePoint. При развертывании решения файлы из модуля копируются в указанные папки на сервере SharePoint.

Элементы модулей

Чтобы создать модуль, добавьте его в проект, выбрав его в диалоговом окне Добавление нового элемента. Затем измените его файл Elements.xml, чтобы включить в него имена файлов, которые нужно развернуть, их расположение в системе и место на сервере SharePoint, куда они должны копироваться.

Ниже приведен пример файла Elements.xml для модуля.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
    <Module Name="Module1">
        <File Path="Module1\Sample.txt" Url="Module1/Sample.txt" />
    </Module>
</Elements>

Новые модули содержат следующие файлы по умолчанию.

Имя файла Description
Elements.xml Файл определения для модуля.
Sample.txt Файл-прототип, служащий в качестве примера файла в модуле.

Файл Elements.xml содержит следующие элементы.

Имя элемента Description
Элементы Содержит все элементы, определенные в модуле.
Модуль Элемент Module имеет единственный атрибут Name (Имя), который задает имя модуля в формате <Module Name="Module1">.

Обратите внимание, что если вы изменяете имя модуля (или его свойство Имя папки), необходимо вручную обновить это имя в элементе Module.

Если указать подкаталог для файлов в элементе Module, Windows SharePoint Services (Windows SharePoint Services) автоматически создаст для них соответствующую структуру каталогов.
Файл Элемент File имеет два параметра, Path (Путь) и Url (URL-адрес).

— Путь: имя и расположение файла в решении SharePoint. Формат: Path="Module1\Sample.txt".

— URL-адрес: расположение, в котором будет развернут файл на сервере SharePoint. Формат: Url="Module1/Sample.txt".

— Тип: необязательный атрибут, имеющий два параметра: GhostableInLibrary и Ghostable. Формат: Type="GhostableInLibrary". При выборе значения GhostableInLibrary файл будет добавлен в библиотеку документов в SharePoint вместе с элементом списка, который сопровождает этот файл при добавлении в библиотеку. При выборе значения Ghostable файл будет добавлен в SharePoint вне библиотеки документов.

Для каждого файла, который вы хотите развернуть, требуется отдельная запись элемента <File> в файле Elements.xml.

См. также