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


Пошаговое руководство. Создание базового проекта определения сайта

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

В этом пошаговом руководстве демонстрируются следующие задачи:

  • Создание определения сайта с помощью шаблона проекта Visual Studio.

  • Создание сайта SharePoint с помощью определения сайта в SharePoint.

  • Добавление визуальной веб-части в решение.

  • Настройка страницы default.aspx сайта путем добавления в нее новой визуальной веб-части.

    Примечание.

    Отображаемые на компьютере имена или расположения некоторых элементов пользовательского интерфейса Visual Studio могут отличаться от указанных в следующих инструкциях. Это зависит от имеющегося выпуска Visual Studio и используемых параметров. Дополнительные сведения см. в разделе Персонализация среды IDE.

Необходимые компоненты

Для выполнения этого пошагового руководства требуются следующие компоненты:

  • Поддерживаемые редакции Microsoft Windows и SharePoint. Дополнительные сведения см. в разделе "Требования к разработке решений SharePoint".

  • Visual Studio.

Создание решения определения сайта

Сначала создайте проект определения сайта в Visual Studio.

Создание проекта определения сайта

  1. В строке меню выберите Файл >Создать >Проект. Если интегрированная среда разработки настроена для использования параметров разработки Visual Basic, в строке меню выберите "Файл>нового проекта".

    Откроется диалоговое окно Создание проекта .

  2. Разверните узел Visual C# или узел Visual Basic, разверните узел SharePoint и выберите узел 2010.

  3. В списке шаблонов выберите шаблон проекта SharePoint 2010.

  4. В поле "Имя" введите TestSiteDef и нажмите кнопку "ОК".

    Откроется мастер настройки SharePoint.

  5. На странице "Указание сайта и уровня безопасности для отладки" введите URL-адрес для сайта SharePoint, в котором требуется выполнить отладку определения сайта, или используйте расположение по умолчанию (http:// System Name/).

  6. В разделе " Что такое уровень доверия для этого решения SharePoint?" , нажмите кнопку "Развернуть как решение фермы".

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

  7. Нажмите кнопку Готово .

    Проект отображается в Обозреватель решений.

  8. В Обозреватель решений выберите узел проекта, а затем в строке меню выберите "Добавить новый элемент проекта>".

  9. В разделе Visual C# или Visual Basic разверните узел SharePoint и выберите узел 2010.

  10. В области "Шаблоны" выберите шаблон определения сайта, оставьте имя в качестве SiteDefinition1 и нажмите кнопку "Добавить".

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

Теперь необходимо создать визуальную веб-часть, отображаемую на главной странице определения сайта.

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

  1. В Обозреватель решений нажмите кнопку "Показать все файлы".

  2. Выберите узел проекта SiteDefinition1, а затем в строке меню выберите "Добавить новый элемент проекта>".

    Откроется диалоговое окно Добавление нового элемента.

  3. Разверните узел Visual C# или узел Visual Basic, разверните узел SharePoint и выберите узел 2010.

  4. В списке шаблонов выберите шаблон визуальной веб-части , сохраните имя VisualWebPart1 по умолчанию и нажмите кнопку "Добавить ".

    Откроется файл VisualWebPart1.ascx .

  5. В нижней части VisualWebPart1.ascx добавьте следующую разметку, чтобы добавить три элемента управления в форму: текстовое поле, кнопку и метку:

    <table>
      <tr>
        <td>
          <asp:TextBox runat="server" ID="tbName"></asp:TextBox>
        </td>
        <td>
          <asp:Button runat="server" ID="btnSubmit" Text = "Change Label Text" OnClick="btnSubmit_Click"></asp:Button>
        </td>
        <td>
          <asp:Label runat="server" ID="lblName"></asp:Label>
        </td>
      </tr>
    </table>
    
  6. В разделе VisualWebPart1.ascx откройте файл VisualWebPart1.ascx.cs (для Visual C#) или VisualWebPart1.ascx.vb (для Visual Basic) и добавьте следующий код:

    protected void btnSubmit_Click(object sender, EventArgs e)
    {            
        lblName.Text = tbName.Text;
    }
    

    Этот код добавляет функциональные возможности для нажатия кнопки веб-части.

Добавление визуальной веб-части на страницу ASPX по умолчанию

Затем добавьте визуальную веб-часть на страницу ASPX по умолчанию определения сайта.

Добавление визуальной веб-части на страницу ASPX по умолчанию

  1. Откройте страницу default.aspx и добавьте следующую строку после тега WebPartPages:

    <%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>
    

    Эта строка связывает имя MyWebPartControls с веб-частью и его кодом. Параметр пространства имен соответствует пространству имен, используемому в файле кода VisualWebPart1.ascx .

  2. Найдите элемент </asp:Content> и замените весь последующий раздел ContentPlaceHolderId="PlaceHolderMain" и его содержимое следующим кодом.

    <asp:Content ID="Content1" ContentPlaceHolderId="PlaceHolderMain" runat="server">
        <MyWebPartControls:VisualWebPart1 runat="server" />
    </asp:Content>
    

    Этот код создает ссылку на визуальную веб-часть, созданную ранее.

  3. В Обозреватель решений откройте контекстное меню узла SiteDefinition1 и выберите "Задать в качестве элемента запуска".

Развертывание и запуск решения определения сайта

Далее, разверните проект в SharePoint, а затем запустите проект.

Развертывание и запуск определения сайта

  • В строке меню выберите "Сборка>deploy TestSiteDef".

  • Нажмите клавишу F5.

    Visual Studio скомпилирует код, добавит его компоненты, поместит все его файлы в WSP-файл пакета и развернет этот WSP-файл на сервере SharePoint. Затем SharePoint устанавливает файлы, а затем активирует компоненты.

Создание сайта на основе определения сайта

Затем создайте сайт с помощью нового определения сайта.

Создание сайта с помощью определения сайта

  1. На сайте SharePoint появится страница "Новый сайт SharePoint".

  2. В разделе "Название и описание" введите "Мой новый сайт" для заголовка и описания сайта.

  3. В разделе "Адрес веб-сайта" введите mynewsite в поле имени URL-адреса.

  4. В разделе "Шаблон" выберите вкладку "Настройки SharePoint".

  5. В списке "Выбор шаблона " выберите SiteDefinition1.

  6. Оставьте другие параметры по умолчанию и нажмите кнопку "Создать ".

    Появится новый сайт.

Тестирование нового сайта

Теперь необходимо протестировать работу созданного сайта.

Тестирование нового сайта

  • На странице ASPX по умолчанию введите текст и нажмите кнопку "Изменить текст метки" рядом с текстовым полем.

    Текст отобразится на метке справа от кнопки.