Создание многократно используемых пользовательских элементов управления для веб-частей или страниц приложений

Статья
05/01/2013

В Visual Studio можно создания пользовательских элементов управления с возможностью повторного использования, которые могут быть использованы страницами приложения и веб-частей, которые выполняются в SharePoint.Эти элементы управления называются пользовательскими элементами управления.Дополнительные сведения о пользовательских элементах управления см. в разделе ASP.NET User Controls.

Создание пользовательского элемента управления

Чтобы создать пользовательский элемент управления, добавьте Пользовательский элемент управления в Пустой проект SharePoint.Дополнительные сведения см. в разделе Практическое руководство. Создание пользовательского элемента управления для страницы приложения или веб-части SharePoint.

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

Файл	Описание
Файл пользовательского элемента управления	Определяет пользовательский элемент управления.Можно разрабатывать пользовательские элементы управления, добавляя элементы управления и разметки в этот файл.
Файл кода	Содержит код, лежащий в основе пользовательского элемента управления.Добавьте в этот файл код для обработки событий.
Файл кода конструктора	Содержит созданный конструктором код, который не следует изменять непосредственно.

Разработка пользовательского элемента управления

Создайте пользовательский элемент управления, воспользовавшись конструктором Visual web Develope в Visual Studio.Этот конструктор отображается при открытии контрольный файл пользовательского элемента управления в проекте и выбрать вкладку Разработка.Дополнительные сведения об использовании этого конструктора см. в разделе Бета-версии Visual Studio 11 для сопоставления веб-содержимого.

Употребление пользовательского элемента управления

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

Для добавления пользовательского элемента управления на страницу приложения добавьте директиву @ Register на страницу приложения, а затем определите пользовательский элемент управления в одном или нескольких прототипах содержимого на странице.Пример выполнения данной задачи для стандартной веб-страницы ASP.NET см. в разделе How to: Include a User Control in an ASP.NET Web Page.

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

<ToolboxItemAttribute(false)> _
Public Class VisualWebPart1
    Inherits WebPart

    Private Const _ascxPath As String = "~/_CONTROLTEMPLATES/VB/VisualWebPart1/VisualWebPart1UserControl.ascx"

    Public Sub New()
    End Sub

    Protected Overrides Sub CreateChildControls()
        Dim control As Control = Page.LoadControl(_ascxPath)
        Controls.Add(control)
        MyBase.CreateChildControls()
    End Sub

    Protected Overrides Sub RenderContents(ByVal writer As HtmlTextWriter)
        MyBase.RenderContents(writer)
    End Sub

End Class

[ToolboxItemAttribute(false)]
public class VisualWebPart1 : WebPart
{
    private const string _ascxPath = @"~/_CONTROLTEMPLATES/CS/VisualWebPart1/VisualWebPart1UserControl.ascx";

    public VisualWebPart1()
    {
    }

    protected override void CreateChildControls()
    {
        Control control = this.Page.LoadControl(_ascxPath);
        Controls.Add(control);
        base.CreateChildControls();
    }

    protected override void RenderContents(HtmlTextWriter writer)
    {
        base.RenderContents(writer);
    }

}

Отладка пользовательского элемента управления

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

При запуске отладчика Visual Studio среда Visual Studio открывает сайт SharePoint.

Откройте страницу приложения, которая включает пользовательский элемент управления, в SharePoint.Если пользовательский элемент управления включен в веб-часть, добавьте ее в страницу веб-части в SharePoint.

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

Связанные разделы

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

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