Разработка решений SharePoint

Статья
06/19/2023

Несколько шаблонов типов проектов SharePoint доступны в Visual Studio для создания сайтов и элементов сайта SharePoint. Список доступных типов проектов см. в разделе Шаблоны проектов и элементов проектов SharePoint. Далее следует описание элементов и свойств проекта SharePoint.

См. дополнительные сведения о сборке Надстроек SharePoint.

Элементы проекта SharePoint

Узлы в проекте SharePoint называются элементами SharePoint. Элементы SharePoint также могут содержать один или несколько вложенных файлов, называемых файлами элементов SharePoint, такими как XML-файлы конфигурации, ASPX-формы и многое другое.

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

Специальные узлы

Каждый проект SharePoint содержит два узла, которые нельзя переименовывать, удалять, вырезать, копировать и перетаскивать из проекта. Это узлы:

Функции
Пакет

Оба эти узла всегда присутствуют в проекте SharePoint, даже если никакие другие компоненты и пакеты не определены в проекте.

Узел "Функции"

Узел Функции содержит одну или несколько функций проекта SharePoint. Функция — это контейнер расширений для SharePoint. После развертывания функции на сервере SharePoint она может быть включена в список определений сайтов или активирована индивидуально администраторами SharePoint на сайтах SharePoint. Дополнительные сведения см. в разделе Работа с компонентами.

При добавлении элемента, например типа содержимого или экземпляра списка, в проект SharePoint он добавляется в функцию в узле Функции . Область элемента определяет, куда добавляется элемент: в новую или существующую функцию. Если область нового элемента совпадает с областью существующей функции, он добавляется в эту функцию. В противном случае элемент добавляется в новую функцию.

Чтобы добавить функцию вручную, выберите команду Добавить функцию из контекстного меню узла функции. Вы можете просмотреть или изменить содержимое функции с помощью конструктора функций. Дополнительные сведения см. в разделе "Практическое руководство. Настройка функции SharePoint".

Когда функция добавляется в проект SharePoint, она появляется в обозревателе решений в виде узла с заданным по умолчанию именем Featurex.feature, где x — уникальный номер. После развертывания функции на сервере SharePoint администратор SharePoint может активировать ее, тем самым сделав ее доступной для пользователей сайта SharePoint.

Узел "Пакет"

Узел Пакет содержит один файл, который реализует механизм распространения проекта SharePoint. Этот файл, называемый пакетом решения, основан на формате CAB и имеет расширение WSP. Пакет решения является файлом развертывания и повторного использования, который содержит набор функций, определений сайтов и сборок, применимых к сайтам SharePoint, которые можно включать и отключать индивидуально. Узел пакета также всегда содержит файл с именем Package.wspdef, XML-файл определения пакета. После развертывания пакета на сервере, где выполняется SharePoint, администратор SharePoint может установить его и активировать его функции.

Вы можете просмотреть или изменить содержимое пакета в конструкторе пакетов, дважды щелкнув узел пакета или выбрав в контекстном меню команду Открыть. Дополнительные сведения см. в статье Создание пакетов решений SharePoint.

Свойства проектов и элементов проектов SharePoint

Проекты SharePoint, как и другие проекты Visual Studio, отображают свойства в окно свойств и на странице свойств. Отображаемые свойства зависят от того, какой узел выбран.

При выборе проекта SharePoint, элемента проекта или узла файла элемента проекта в обозревателе решенийв окне «Свойства» или на странице свойств отображаются следующие свойства:

Свойства проекта

Имя свойства	Description
Активная конфигурация развертывания	Указывает ряд шагов, выполненных в процессе развертывания. Дополнительные сведения см. в статье "Практическое руководство. Изменение конфигурации развертывания SharePoint".
Место развертывания сборки	Определяет, где находятся сборки приложения SharePoint . Допустимое расположение сборок: либо GlobalAssemblyCache (по умолчанию), либо WebApplication. Если свойству Sandboxed Solution присвоено значение true, это свойство отключается.
Автоматически отозвать после отладки	Указывает, автоматически ли развернутое решение удаляется из SharePoint после запуска приложения в режиме отладки в Visual Studio. Если параметр выбран, решение отзывается, когда интегрированная среда разработки возвращается в режим конструктора после отладки. Если параметр не выбран, решение не отзывается. Дополнительные сведения см. в разделе Отзыв решения.
Изменить конфигурации	Задает конфигурацию развертывания для проекта. Дополнительные сведения см. в статье "Практическое руководство. Изменение конфигурации развертывания SharePoint и развертывание, публикация и обновление пакетов решений SharePoint".
Включить отладку Silverlight (вместо отладки скриптов)	Если выбран этот параметр, к процессу отладки присоединяется отладчик Silverlight. Если параметр не выбран, к процессу отладки присоединяется отладчик скриптов. Дополнительные сведения см. в разделе Общие сведения об отладке Silverlight.
Включить сборку в пакет	Указывает, должна ли сборка проекта включаться в пакет во время построения.
Строка команды после развертывания	Задает команды, выполняемые после развертывания решения SharePoint. Эта строка поддерживает любые пакетные команды, а также разрешение переменных MSBuild. Для получения дополнительной информации см. How to: Set SharePoint Deployment Commands.
Строка команды до развертывания	Задает команды, выполняемые до развертывания решения SharePoint. Эта строка поддерживает любые пакетные команды, а также разрешение переменных MSBuild. Для получения дополнительной информации см. How to: Set SharePoint Deployment Commands.
Файл проекта	Имя файла, содержащего сведения о сборке и конфигурации, а также другую информацию о проекте.
Папка проекта	Расположение файла проекта в системе. (только для чтения).
Sandboxed Solution	Указывает, должен ли проект развертываться как изолированное решение, называемое также пользовательским решением. Изолированные решения не всегда являются доверенными. Значение true означает, что проект развертывается как изолированное решение, значение false означает, что проект развертывается как решение фермы. Дополнительные сведения см. в разделах Sandboxed Solution Considerations и Differences Between Sandboxed and Farm Solutions.
URL-адрес сайта	Указывает URL-адрес целевого сайта для этого проекта.
Автозапускаемый элемент	Указывает первый элемент в проекте, который должен быть запущен.

При выборе файла элемента SharePoint (например, рабочего процесса или функции в узле «Функции») в окне «Свойства» отображаются следующие свойства:

Свойства элемента проекта

Имя свойства	Description
Устранение конфликта развертывания	Указывает действие к исполнению при развертывании элемента проекта, свойства которого идентичны свойствам элемента, уже существующего на сервере. Для получения дополнительной информации см. Troubleshooting SharePoint Packaging and Deployment.
Свойства функций	Задает набор значений (сохраняемых в виде пар «ключ — значение»), который включается в состав функции при ее развертывании в SharePoint. После развертывания функции значения свойств можно использовать в коде. Дополнительные сведения см. в разделе Providing Packaging and Deployment Information in Project Items.
Приемник компонента	Предоставляет код, который выполняется при возникновении определенных событий для элемента проекта, содержащего функцию. Дополнительные сведения см. в разделе Providing Packaging and Deployment Information in Project Items.
Имя папки	Имя папки элемента проекта SharePoint.
Выходные ссылки проекта	Задает зависимость, например сборку, которую должен запустить элемент проекта. Дополнительные сведения см. в разделе Providing Packaging and Deployment Information in Project Items.
Записи безопасных элементов управления	Задает элементы управления, к которым можно безопасно открыть доступ для редактирования пользователям, не являющимся доверенными. Дополнительные сведения см. в разделе Providing Packaging and Deployment Information in Project Items.

Свойства файла элемента проекта

Имя свойства	Description
Действие при сборке	Определяет, как файл связан с процессами сборки и развертывания. Дополнительные сведения см. в разделе Свойства файлов.
Копировать в выходной каталог	Указывает, будет ли файл (файлы) исходного кода скопирован в выходной каталог. Может использоваться одно из следующих значений: - Не копировать - Всегда копировать - Копировать, если новее Дополнительные сведения см. в разделе Свойства файлов.
Специальный инструмент	Задает имя инструмента, если таковой имеется, преобразующего файл во время разработки и помещающего результат преобразования в другой файл. Например, набор данных (. XSD)-файл имеет пользовательское средство по умолчанию. Дополнительные сведения см. в разделе Свойства файлов.
Пространство имен настраиваемого инструмента	Пространство имен, в которое копируются выходные данные пользовательского инструмента. Дополнительные сведения см. в разделе Свойства файлов.
Расположение развертывания	Полный путь к файлу на сервере SharePoint. Этот путь состоит из корневого каталога развертывания и вложенных свойств пути развертывания.
Путь развертывания	Относительный путь к файлу SharePoint Server, например Workflow1\. Полный путь к файлу создается путем объединения значения Deployment Path со значением Deployment Root до конца. Выбор значения RootFile для свойства типа развертывания изменяет корневое свойство развертывания на <SharePointRoot>\, что приводит к полному пути <SharePointRoot>\Workflow1\. Дополнительные сведения см. в разделе Упаковка и развертывание решений SharePoint.
Deployment Root	Строка. Корневая папка, в которой файл развертывается на сервере SharePoint. Например, <SharePointRoot>\Template\Features\<FeatureName>\. Значение свойства Deployment Root определяется параметром Deployment Type .
Тип развертывания	Тип развертывания файла, определяющий его значение Deployment Root . Может использоваться одно из следующих значений: NoDeployment: <нет значения> ElementManifest: <SharePointRoot>\Template\Features\<FeatureName>\ ElementFile: <SharePointRoot>\Template\Features\<FeatureName>\ TemplateFile: <SharePointRoot>\Template\ RootFile: <SharePointRoot>\ GlobalResource: <SharePointRoot>\Resources\ ClassResource: <ClassResourcePath>\ Дополнительные сведения см. в разделе DeploymentType.
Имя файла	Имя файла или папки для файла элемента.
Полный путь	Расположение файла для элемента. (только для чтения).

Заголовок	Description
Шаблоны проектов и элементов проектов SharePoint	Описывает шаблоны проектов и элементов проекта SharePoint, доступные в Visual Studio.
Практическое руководство. Добавление элементов в проект SharePoint	Описывает добавление новых или существующих элементов в проект Visual Studio SharePoint.
Пошаговое руководство. Создание столбца сайта, типа контента и списка для SharePoint	Описание по шагам процедуры создания настраиваемого поля, типа содержимого, определения списка и экземпляра списка.
Практическое руководство. Создание приемника событий	Описание добавления приемника событий для проекта, созданного в пошаговом руководстве. Создание столбца сайта, типа контента и списка для SharePoint.
Создание решений рабочих процессов SharePoint	Описание процедуры создания проектов рабочих процессов, включающее формы сопоставления и формы запуска рабочих процессов.
Создание страниц для SharePoint	Описание процедуры создания страниц, например страниц приложений, страниц сайтов, эталонных страниц и макетов страниц для SharePoint.
Создание веб-частей для SharePoint	Описание процедуры добавления элементов управления, позволяющих пользователям напрямую изменять содержимое, внешний вид и поведение страниц сайта SharePoint с помощью браузера.
Создание многократно используемых элементов управления для веб-частей или страниц приложений	Описание процедуры создания пользовательских элементов управления, которые можно размещать на страницах приложений и в веб-частях, используемых в SharePoint.
Интеграция бизнес-данных в SharePoint	Описание процедуры интеграции данных, полученных из веб-служб и серверных приложений, в приложения SharePoint.
Создание определений сайтов SharePoint	Описание процедуры создания определений сайтов — шаблонов, которые используются для создания сайтов SharePoint.
Импорт элементов из существующего сайта SharePoint	Описывает, как импортировать такие элементы, как типы контента и модули из существующего сайта SharePoint в проект Visual Studio SharePoint.
Использование модулей для включения файлов в решение	Описывает использование модулей для развертывания файлов из проекта Visual Studio на сайте SharePoint.
Просмотр подключений SharePoint с помощью обозревателя сервера	Описание способа просмотра локальных сайтов SharePoint с помощью обозревателя серверов.
Предоставление сведений об упаковке и развертывании в элементах проекта	Описание способа использования свойств элементов проекта для предоставления сведений об упаковке и развертывании для проектов, например записей безопасных элементов управления, выходных ссылок проекта и свойств функций.
Практическое руководство. Добавление и удаление сопоставленных папок	Описание процедуры добавления в проект сопоставленных папок для более удобного доступа к ресурсам SharePoint.
Замечания об изолированных решениях	Описание проблем, связанных с изолированными решениями.
Безопасность решений SharePoint	Описание соображений безопасности для разработки решений SharePoint в Visual Studio.
Диалоговое окно выбора URL-адресов (разработка SharePoint в Visual Studio)	Описание диалогового окна, которое можно использовать для добавления ссылок в виде путей к ресурсам в проекте или на локальном сервере SharePoint.

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