Создание веб-частей для SharePoint

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

Вы можете создавать и отлаживать веб-части на сайте SharePoint с помощью шаблонов из Visual Studio.

Создание веб-части в Visual Studio

Чтобы создать веб-часть, добавьте элемент Web Part (Веб-часть) в любой проект SharePoint. Элемент Веб-часть можно использовать в изолированном решении или в решении фермы.

Если вы хотите визуально разработать веб-часть с помощью конструктора, создайте проект визуальной веб-части или добавьте элемент Visual Web Part (Визуальная веб-часть) в любой проект SharePoint. Элемент Визуальная веб-часть можно использовать только в решении фермы.

Элемент "Веб-часть"

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

Файл	Description
Elements.xml	Содержит сведения, которые файл определения компонента в проекте использует для развертывания веб-части.
WEBPART-файл	Содержит сведения, необходимые SharePoint для отображения этой веб-части в коллекции веб-частей.
Файл кода	Содержит методы, добавляющие элементы управления в веб-часть и создающие пользовательское содержимое в веб-части.

Дополнительные сведения см. в статье "Практическое руководство. Создание веб-части SharePoint".

Элемент "Визуальная веб-часть"

Визуальная веб-часть — это веб-часть, созданная с помощью конструктора Visual Web Developer в Visual Studio. Визуальная веб-часть функционирует так же, как и любая другая веб-часть. Чтобы добавить в веб-часть элементы управления, такие как кнопки и текстовые поля, добавьте код в XML-файл. Однако чтобы добавить элементы управления в визуальную веб-часть, их необходимо перетащить или скопировать в веб-часть из панели элементов. Затем конструктор создает необходимый код в XML-файле. См. инструкции . Создание веб-части SharePoint с помощью конструктора.

Элементы управления SharePoint

Visual Studio предоставляет несколько элементов управления для создания страниц SharePoint, например страниц приложений. Эти элементы управления отображаются в панели элементов в разделе Элементы управления SharePoint. Функциональные возможности этих элементов управления наследуются из пространства имен Microsoft.SharePoint.SharePoint.WebControls, которое содержит элементы управления ASP.NET, используемые на страницах сайта и списка SharePoint.

Имя элемента управления	Description
AspMenu	Вставляет меню ASP. Дополнительные сведения см. в разделе Обзор элементов управления меню.
CssLink	Вставляет элемент LINK на страницу ASPX и применяет одну или несколько внешних таблиц стилей, определенных параметром CssRegistration.
DateTimeControl	Вставляет элемент управления DateTime на страницу ASPX.
FormDigest	Вставляет проверку безопасности на страницу ASPX.
ListProperty	Возвращает свойство указанного списка.
ProjectProperty	Возвращает глобальное свойство текущего веб-сайта.
RssLink	Вставляет ссылку на RSS-канал на страницу ASPX.
ScriptLink	Предоставляет свойства и методы для регистрации на странице ресурсов, таких как скрипты, чтобы их можно было запрашивать при подготовке страницы к просмотру.
Тема	Применяет тему к странице ASPX.

Отладка веб-части

Отладка проекта SharePoint, содержащего веб-часть, выполняется так же, как отладка других проектов Visual Studio. При запуске отладчика Visual Studio открывается сайт SharePoint.

Чтобы начать отладку кода, добавьте веб-часть на страницу веб-частей в SharePoint.

Дополнительные сведения об отладке проектов SharePoint см. в разделе Устранение неполадок решений SharePoint.

Ограничения визуальной веб-части

Начиная с Visual Studio вы можете добавлять визуальные веб-части в изолированные решения SharePoint и решения фермы. Однако визуальные веб-части имеют следующие ограничения.

• Визуальные веб-части не поддерживают заменяемые параметры. Дополнительные сведения см. в разделе Заменяемые параметры.

• Пользовательские элементы управления или визуальные веб-части нельзя перетаскивать и удалять, а также копировать в визуальные веб-части. Это действие приводит к возникновению ошибки сборки.

• Визуальные веб-части напрямую не поддерживают токены сервера SharePoint, такие как $SPUrl. Дополнительные сведения см. в разделе "Ограничения токенов в изолированных визуальных веб-частях" статьи Устранение неполадок решений SharePoint.

• Визуальные веб-части в изолированном решении иногда получают ошибку", "Запрос на выполнение изолированного кода был отклонен, так как служба узла изолированного кода была слишком занята для обработки запроса". Дополнительные сведения об этой ошибке см. в записи блога группы разработчиков SharePoint.

• Отладка JavaScript на стороне сервера в Visual Studio не поддерживается, но поддерживается отладка JavaScript на стороне клиента.

  Хотя встроенный код JavaScript можно добавить в файл разметки на стороне сервера, отладка не поддерживается для точек останова, добавленных в разметку. Для отладки JavaScript сделайте ссылку на внешний файл JavaScript в файле разметки, а затем задайте точки останова в файле JavaScript.

• Отладка встроенного кода ASP.NET должна выполняться в созданном файле кода вместо файла разметки.

• Визуальные веб-части не поддерживают использование директивы <@ Assembly Src=.

• Веб-элементы управления SharePoint и некоторые элементы управления ASP.NET не поддерживаются в изолированной среде SharePoint. При использовании неподдерживаемых элементов управления в визуальной веб-части в изолированном решении возникает ошибка "Тип или имя пространства имен Theme не существует в пространстве имен Microsoft.SharePoint.WebControls".

  Дополнительные сведения об изолированных решениях см. в разделах Различия между изолированными решениями и решениями фермы.

Создание веб-частей старого стиля на основе SharePoint

Шаблоны в Visual Studio можно использовать для создания пользовательских веб-частей ASP.NET 2.0 для SharePoint. ASP.NET веб-части версии 2.0 основаны на инфраструктуре веб-частей ASP.NET и являются рекомендуемыми типами для новых проектов.

В редких случаях может потребоваться создать веб-часть с помощью веб-части старого стиля на основе SharePoint. Чтобы создать такие веб-части, можно использовать Visual Studio, но Visual Studio не предоставляет шаблоны, специально предназначенные для их создания.

Дополнительные сведения о том, когда может потребоваться создать веб-часть старого стиля на основе SharePoint, см. в разделе Инфраструктура веб-частей в Windows SharePoint Services. Дополнительные сведения о создании веб-части с помощью веб-части старого стиля на основе SharePoint см. в разделе Пошаговое руководство. Создание базовой веб-части SharePoint.

См. также

Заголовок	Description
Практическое руководство. Создание веб-части SharePoint	Показывается, как создавать веб-части для страниц SharePoint.
Практическое руководство. Создание веб-части SharePoint с помощью конструктора	Показывается, как создавать веб-части для SharePoint с помощью визуального конструктора.
Практическое руководство. Создание пользовательского элемента управления для страницы или веб-части приложения SharePoint	Показывается, как создавать пользовательские элементы управления с возможностью многократного использования, которые можно размещать на страницах приложений и в веб-частях, работающих в SharePoint.
Пошаговое руководство. Создание веб-части для SharePoint	Описывается разработка веб-части для SharePoint.
Пошаговое руководство. Создание веб-части для SharePoint с помощью конструктора	Описывается создание веб-части для SharePoint путем перетаскивания элементов управления в область визуального проектирования.
Пошаговое руководство. Создание веб-части Silverlight, отображающей OData для SharePoint	Описывается разработка веб-части для SharePoint, которая размещает приложение Silverlight и отображает данные из списков SharePoint.