Использование модулей для включения файлов в решение
Бывают ситуации, когда требуется развернуть файлы на сервере SharePoint вне зависимости от их типа, например главные страницы.Это можно сделать с помощью модулей (не путать с модулями ядра Visual Basic).Модули — это контейнеры для файлов решения SharePoint.При развертывании решения содержащиеся в модуле файлы копируются в указанные папки на сервере SharePoint.
Элементы модулей
Чтобы создать модуль, добавьте его в проект, выбрав его в диалоговом окне Добавление нового элемента.Затем измените содержащийся в нем файл Elements.xml, добавив в него имена файлов, которые требуется развернуть, их расположение в системе и расположение на сервере SharePoint, в которое требуется их скопировать.
Ниже приведен пример файла Elements.xml для модуля.
<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
<Module Name="Module1">
<File Path="Module1\Sample.txt" Url="Module1/Sample.txt" />
</Module>
</Elements>
Создаваемые модули содержат следующие файлы по умолчанию:
Имя файла |
Описание |
---|---|
Elements.xml |
Файл определения модуля. |
Sample.txt |
Файл, представляющий собой образец файла в модуле. |
Файл Elements.xml содержит следующие элементы:
Имя элемента |
Описание |
---|---|
Elements |
Содержит все элементы, определенные в модуле. |
Модуль |
У элемента Module имеется только один атрибут Name, указывающий имя модуля в формате <Module Name="Module1">.
Примечание
Если требуется изменить имя модуля (или его свойство Folder Name), необходимо вручную обновить имя в элементе Module.
Если указать подкаталог для файла (или файлов) в элементе Module, службы Windows SharePoint Services (WSS) автоматически создадут для него соответствующую структуру каталогов. |
Файл |
Элемент File имеет два параметра: Path и Url.
Имя атрибутаОписание
ПутьИмя и расположение файла в решении SharePoint.Используется следующий формат: Path="Module1\Sample.txt".
UrlРасположение для развертывания файла на сервере SharePoint.Используется следующий формат: Url="Module1/Sample.txt".
ТипНеобязательный атрибут, имеющий два возможных значения: GhostableInLibrary и Ghostable.Используется следующий формат: Type="GhostableInLibrary".Если указать значение GhostableInLibrary, файл будет добавлен в библиотеку документов SharePoint вместе с сопутствующим элементом списка.Если указать значение Ghostable, файл будет добавлен в SharePoint вне библиотеки документов.
|
Для каждого развертываемого файла требуется отдельная запись в элементе <File> в файле Elements.xml.
См. также
Задачи
Практическое руководство. Включение файлов с помощью модуля