Настройка домашней страницы для мобильных устройств

Статья
04/21/2015

Дата последнего изменения: 2 февраля 2011 г.

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

В данном руководстве демонстрируется, как настроить домашнюю страницу для мобильных устройств путем реализации настраиваемого элемента управления RenderingTemplate. Приводится пример, показывающий настройку раздела заголовка домашней страницы. Общие сведения о действиях по настройке любого раздела домашней страницы для мобильных устройств см. в статье Практическое руководство. Настройка домашней страницы для мобильных устройств.

Перед настройкой

Объект SPMobileComponent, свойству TemplateName которого явно присваивается значение WebPartMobileSummaryViewTitle, объявляется в обоих элементах HeaderTemplate файла mblwiki.aspx, который используется в качестве домашней страницы для мобильных устройств для сайта группы (STS). Ниже показан один из этих элементов:

<HeaderTemplate>
  <SPMobile:SPMobileControlContainer RunAt="Server" Weightless="true">
    <SPMobile:SPMobileComponent RunAt="Server" 
       TemplateName="WebPartMobileSummaryViewTitle" />
    <SPMobile:SPMobileComponent RunAt="Server" 
       TemplateName="MobileDefaultSeparator" />
  </SPMobile:SPMobileControlContainer>
</HeaderTemplate>

Этот объект вызывает объект RenderingTemplate в файле MobileDefaultTemplates.ascx с идентификатором "WebPartMobileSummaryViewTitle". Объект RenderingTemplate показан ниже:

<SharePoint:RenderingTemplate RunAt="Server" 
  id="WebPartMobileSummaryViewTitle">
  <Template>
    <SPMobile:SPMobileWebTitle RunAt="Server" Prefix="WebPartMobile" />
  </Template>
</SharePoint:RenderingTemplate>

Как показано в этом примере, шаблон отображения вызывает объект выбора шаблона класса SPMobileWebTitle. Объект выбора шаблона строит следующий идентификатор шаблона отображения и вызывает шаблон отображения с этим идентификатором: WebPageMobile_STS_HomePage_Title. Если шаблона отображения с таким идентификатором не существует, будет использоваться шаблон WebPageMobile_Default_HomePage_Title.

В Microsoft SharePoint Foundation не существует объекта RenderingTemplate с идентификатором Mobile_STS_HomePage_Title. В этом пошаговом руководстве создается такой объект, который будет использоваться для отображения заголовка домашней страницы в двухцветной панели. Перед выполнением настройки объект WebPageMobile_Default_HomePage_Title будет отображать заголовок домашней страницы STS, как показано на этом снимке экрана. Текст заголовка соответствует заголовку соответствующей обычной домашней страницы STS. Текст отображается белыми буквами в панели темно-синего цвета.

Отображение области заголовка по умолчанию для домашней страницы сайта группы

Ненастроенная домашняя страница для мобильного устройства

Процедура

Настройка раздела заголовка домашней страницы для мобильных устройств STS

В Microsoft Visual Studio создайте Пустой проект SharePoint. Выберите фермы, а не для песочницы.
Добавьте сопоставленную папку SharePoint в папку TEMPLATE\ControlTemplates.

Щелкните новую папку правой кнопкой мыши и добавьте Пользовательский элемент управления SharePoint. Присвойте ASCX-файлу имя, которое позволит его отличить от файлов других поставщиков решений, например ContosoMobileRenderingTemplates.ascx. Visual Studio автоматически добавит файл в манифест решения SharePoint и настроит его на развертывание в папку %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\ControlTemplates.

Совет
Не добавляйте Пользовательский элемент управления щелчком правой кнопкой мыши по проекту в обозревателе решений. При добавлении Пользовательского элемента управления таким образом Visual Studio помещает его во вложенную папку папки TEMPLATE\ControlTemplates. Если элемент управления не переместить, Visual Studio развертывает его в соответствующую вложенную папку %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\ControlTemplates. Шаблоны отображения для мобильных устройств, находящиеся во вложенных папках, не загружаются.

Не добавляйте Пользовательский элемент управления щелчком правой кнопкой мыши по проекту в обозревателе решений. При добавлении Пользовательского элемента управления таким образом Visual Studio помещает его во вложенную папку папки TEMPLATE\ControlTemplates. Если элемент управления не переместить, Visual Studio развертывает его в соответствующую вложенную папку %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\ControlTemplates. Шаблоны отображения для мобильных устройств, находящиеся во вложенных папках, не загружаются.

Удалите файлы .ascx.cs и .ascx.designer.cs (либо .ascx.vb и .ascx.designer.vb). Эти файлы для данного проекта не требуются.

Замените весь раздел директив в ASCX-файле на следующую разметку.

<%@ Register TagPrefix="GroupBoardMobile"   Namespace="Microsoft.SharePoint.Applications.GroupBoard.MobileControls" Assembly="Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
<%@ Control Language="C#"   %> 
<%@ Assembly Name="Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %> 
<%@ Register TagPrefix="mobile" Namespace="System.Web.UI.MobileControls" Assembly="System.Web.Mobile, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" %> 
<%@ Register TagPrefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %> 
<%@ Register TagPrefix="SPMobile" Namespace="Microsoft.SharePoint.MobileControls" Assembly="Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %> 
<%@ Register TagPrefix="WPMobile" Namespace="Microsoft.SharePoint.WebPartPages" Assembly="Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>

Ниже директив добавьте следующую разметку. При этом будет создан объект RenderingTemplate с идентификатором, поиск которого будет осуществляться синтаксическим анализатором при отображении области заголовка для домашней страницы STS.
```
<SharePoint:RenderingTemplate 
  ID="WebPartMobile_STS_HomePage_Title" RunAt="Server">


</SharePoint:RenderingTemplate>
```
В элементе RenderingTemplate определите элемент Template с дочерним элементом управления SPMobilePaddedPanel. Установите атрибуты метки ForeColor, BackColor, Font-Size, и Font-Bold, как показано в следующем примере:
```
<Template>
    <SPMobile:SPMobilePaddedPanel RunAt="Server" 
      ForeColor="#FFFFFF" 
      BackColor="#990033" 
      Font-Bold="True" 
      Font-Size="13pt">
      <WPMobile:WebPartMobilePageTitle RunAt="Server" />
    </SPMobile:SPMobilePaddedPanel>
</Template>
```
В меню Построение выберите пункт Развернуть решение. При этом ACSX-файл будет автоматически сохранен и развернут в папку %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATES\ControlTemplates, а веб-приложение — перезапущено, в результате чего все ACSX-файлы в этой папке будут перезагружены.
Перейдите на домашнюю страницу любого сайта STS в развертывании с использованием устройства или эмулятора. Заголовок должен отображаться в панели красного цвета, размещенной внутри панели темно-синего цвета. (Внешняя панель объявляется непосредственно на странице mblwiki.aspx и не удаляется в результате настройки. Чтобы удалить ее, потребуется создать новую домашнюю страницу для сайтов STS и использовать функцию перенаправления на домашнюю страницу для перенаправления мобильных устройств на новую страницу. Дополнительные сведения о перенаправлении на домашнюю страницу см. в статьях Перенаправление на домашнюю страницу и Практическое руководство. Настройка домашней страницы для мобильных устройств с помощью перенаправления.)