Создание страниц приложений для SharePoint
Страница приложения — это веб-страница ASP.NET, предназначенная для использования на веб-сайте SharePoint. Страницы приложений — это специализированный тип страницы ASP.NET. Основное различие между страницей приложения и стандартной страницей ASP.NET заключается в том, что страница приложения содержит содержимое, объединенное с главной страницей SharePoint. Эталонная страница позволяет страницам приложений совместно использовать тот же внешний вид и поведение, что и другие страницы на сайте.
Visual Studio позволяет создавать страницы приложений с помощью конструктора. Конструктор отображает область содержимого для каждого заполнителя контента, определенного на главной странице. Вы можете создать страницу приложения, перетащив элементы управления в эти области содержимого.
Страницы приложения
Страницы приложений совместно используются на всех сайтах на сервере, в то время как страница сайта относится к одному сайту. Дополнительные сведения о типах страниц SharePoint.
По умолчанию большинство страниц, которые отображаются при создании сайта SharePoint, являются страницами сайта. Страницу сайта можно добавить в библиотеку страниц SharePoint. Пользователи могут настроить страницу сайта с помощью таких средств, как SharePoint Designer. Страница сайта также может размещать такие функции, как динамические веб-части и зоны веб-частей.
Страницы приложений не могут выполнять эти действия. Однако страница приложения — это лучший тип страницы для создания, если требуется, чтобы страница содержала пользовательский код. Хотя вы можете добавить пользовательский код на страницу сайта, код перестает работать, когда пользователь настраивает страницу с помощью таких средств, как SharePoint Designer.
Примечание.
Visual Studio не предоставляет шаблоны, помогающие создавать страницы сайтов для сайта SharePoint. Дополнительные сведения см. в разделе "Типы страниц SharePoint".
Создание страницы приложения
Чтобы создать страницу приложения, добавьте элемент страницы приложения в проект SharePoint. При создании страницы приложения Visual Studio добавляет в проект следующие папки:
Папка | Description |
---|---|
Макеты | Карты в виртуальный каталог _layouts файловой системы SharePoint. |
Вложенные папки макетов | Содержит файлы, составляющие страницу приложения. По умолчанию эта папка имеет то же имя, что и проект. Эту папку можно переименовать в любое время. При запуске проекта Visual Studio развертывает эту папку в _layouts виртуальном каталоге файловой системы SharePoint. |
Visual Studio добавляет в проект следующие файлы:
Файл | Description |
---|---|
ASP.NET файл страницы (ASPX) | Содержит XML-разметку, определяющую страницу. |
Файл кода страницы приложения | Содержит код на странице приложения. Добавьте код, обрабатывающий события в этот файл. |
Файл кода конструктора страниц приложения | Содержит код, созданный конструктором. Не изменяйте этот файл напрямую. |
Проектирование и отладка страницы приложения
Проектирование содержимого страницы приложения с помощью представления конструктора в Visual Studio. Этот конструктор отображается при открытии страницы приложения в проекте (дважды щелкнув его или открыв контекстное меню, а затем выбрав "Открыть") и нажмите кнопку "Конструктор " в нижней части редактора.
Примечание.
Вы можете создать страницу только в исходном представлении конструктора. Представление конструктора отключено для страниц приложений.
Вы можете отлаживать страницу приложения так же, как и другие элементы проекта SharePoint в Visual Studio. При запуске отладчика Visual Studio открывается сайт SharePoint.
Чтобы просмотреть страницу приложения, необходимо вручную перейти к расположению страницы приложения (например, http:// Server_Name/_layouts/Project_Name/ApplicationPage1.aspx).
Дополнительные сведения об отладке проектов SharePoint см. в разделе Устранение неполадок решений SharePoint.
Выбор главной страницы
По умолчанию элемент страницы приложения ссылается на главную страницу сайта, который вы используете для отладки проекта. Эта страница называется v4.master, и ее можно найти в коллекции эталонных страниц сайта SharePoint.
Вы можете явно изменить главную страницу, используемую страницей приложения, задав MasterPageFile
атрибут элемента приложения Page
. (Например: MasterPageFile="~/_layouts/applicationv4.master"
). На самом деле этот атрибут необходимо задать, если динамические главные страницы не включены на сервере SharePoint. Дополнительные сведения о главных страницах в SharePoint см. в разделе "Главные страницы".