Стандартный блок: веб-части

Статья
04/21/2015

Дата последнего изменения: 9 апреля 2010 г.

Применимо к: SharePoint Foundation 2010

В этой статье
Объектная модель веб-частей
XML для веб-частей
Области, связанные с веб-частями
Дополнительные сведения о веб-частях

Веб-части — это элементы управления на стороне сервера, которые работают в контексте страниц сайта Microsoft SharePoint Foundation. Их можно использовать для настройки пользовательского интерфейса и редактирования содержимого страницы сайта. В Microsoft SharePoint Foundation включены веб-части, а также возможность для создания собственных веб-частей. Есть два типа поддерживаемых веб-частей в SharePoint Foundation. Они называются веб-части SharePoint и веб-части ASP.NET. Веб-части ASP.NET используют базовый класс System.Web.UI.WebControls.WebParts.WebPart, а веб-части SharePoint используют базовый класс Microsoft.SharePoint.WebPartPages.WebPart. Поддерживаются оба типа, но рекомендуется применять веб-части ASP.NET для всех новых проектов.

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

Объектная модель веб-частей

Веб-части SharePoint Foundation основаны на инфраструктуре веб-частей Microsoft ASP.NET. Для создания веб-частей для приложений, предназначенных для SharePoint Foundation, следует создать пользовательские веб-части поверх инфраструктуры веб-частей ASP.NET. Однако в очень редких случаях требуется создать веб-части, которые поддерживают возможности SharePoint Foundation, недоступные в инфраструктуре веб-частей ASP.NET.

Веб-части ASP.NET

Инфраструктура веб-частей ASP.NET основана на классе WebPartManager, который управляет жизненным циклом экземпляров веб-частей во время работы.

Каждая страница ASP.NET, которая использует элементы управления веб-части, должна содержать следующие объекты для поддержки персонализации:

только один объект WebPartManager, который отслеживает, какие веб-части были добавлены в каждую область, хранит и получает данные о настройке и персонализации каждой веб-части;
один или более объектов WebPartZone, в которые помещаются веб-части.

Для запуска веб-частей SharePoint Foundation в приложении ASP.NET необходимо создать ASPX-страницу, содержащую только один экземпляр элемента управления WebPartManager и один или более элементов управления WebPartZone. Элемент управления WebPartManager отвечает за сериализацию данных веб-частей, а также за хранение и получение этих данных из базы данных служб.

Элементы управления SPWebPartManager и WebPartZone управляют сериализацией данных, связанных с веб-частями, в соответствующей базе данных контента служб SharePoint Foundation. Чтобы иметь возможность сохранять данные, веб-части ASP.NET должны располагаться на странице вместе с этими двумя элементами управления.

Так как эти элементы управления SharePoint Foundation требуются для страниц, которые содержат веб-части, нельзя просто копировать страницу ASP.NET на сайт SharePoint Foundation. Для перемещения веб-частей ASP.NET из приложения ASP.NET в приложение SharePoint Foundation экспортируйте их из ASP.NET и как WEBPART-файлы импортируйте на сайт SharePoint Foundation.

Веб-части SharePoint

Инфраструктура веб-частей SharePoint Foundation использует многие элементы управления из набора ASP.NET, а также представляет несколько собственных элементов управления, наследующих от базовых классов, поставляемых в наборе элементов управления веб-частей ASP.NET.

Например, страницы сайта SharePoint Foundation не используют стандартный класс ASP.NET WebPartManager. Вместо этого они используют применяемый для SharePoint Foundation класс SPWebPartManager, который наследуется от класса ASP.NET WebPartManager.

Примечание
Главная страница по умолчанию, предоставленная с SharePoint Foundation, включает экземпляр класса SPWebPartManager, поэтому этот элемент управления автоматически включается со всеми страницами контента SharePoint Foundation.

Аналогично веб-частей для веб-сайта SharePoint Foundation также использует применяемый для SharePoint Foundation класс WebPartZone, который наследуется от класса ASP.NET WebPartZone.

XML для веб-частей

Веб-части в SharePoint Foundation используют различные разделы XML для настройки, развертывания и защиты на веб-сайте. Некоторые XML не входят в область данной статьи, но в конце раздела представлены ссылки на соответствующие сведения.

Определения веб-частей

Файл определения веб-части (.webpart) представляет собой простой XML-файл, содержащий параметры свойств отдельной веб-части. Чтобы импортировать веб-часть на страницу, следует загрузить на нее файл .webpart или добавить веб-часть в коллекцию веб-частей. Чтобы отобразить веб-часть после загрузки, перетащите ее в одну из областей страницы. Чтобы отобразить установленные по умолчанию имя и описание веб-части после ее импорта, следует включить свойства Title и Description. Чтобы установить значения других свойств веб-части во время импорта, их также следует определить в файле .webpart. Файл .webpart имеет следующий вид.

<?xml version="1.0" encoding="utf-8" ?> 
  <webParts>
     <webPart xmlns="https://schemas.microsoft.com/WebPart/v3">
       <metaData>
         <type name="TypeName, Version=VersionNumber, Culture=neutral, 
         PublicKeyToken=PublicKeyToken" /> 
         <importErrorMessage>Cannot import this Web 
         Part.</importErrorMessage> 
       </metaData>
       <data>
         <properties>
           <property name="Title" type="string">
              WebPartTitle
           </property>
           <property name="Description" type="string">
              WebPartDescription
           </property>
         </properties>
       </data>
     </webPart>
   </webParts>

Записи блока SafeControl

Чтобы запретить ненадежным пользователям произвольное добавление кода ASPX-страниц на стороне сервера, в SharePoint Foundation используется список безопасных элементов управления (SafeControls). Списком SafeControls является список утвержденных элементов управления и веб-частей, специфичных для сайта SharePoint, который был обозначен как безопасный для вызова любой страницы ASPX на сайте. Этот список содержится в файле web.config в корне веб-приложения. Элемент списка безопасных элементов управления представляет собой XML-объявление веб-части следующего вида.

<SafeControl Assembly="AssemblyNameWithoutDLLExtension, Version=AssemblyVersionNumber, Culture=neutral, PublicKeyToken=PublicKeyToken" Namespace="NamespaceOfYourProject" TypeName="*" Safe="True" />

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

Безопасность доступа к коду

Безопасность доступа к коду — этот модель ограничения ресурсов в SharePoint Foundation, которая ограничивает доступ сборки к защищенным системным ресурсам и операциям. SharePoint Foundation располагает стандартными политиками безопасности, созданными на основе встроенных политик безопасности ASP.NET. По умолчанию SharePoint Foundation использует набор разрешений, предоставляющий минимальный уровень доступа к системным ресурсам, для защиты сервера и базовой инфраструктуры от вредоносного кода.

XML, используемый для безопасности доступа к коду, не входит в область данного раздела. Дополнительные сведения о защите веб-частей см. в разделе Защита веб-частей в службах SharePoint Foundation.