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

Практическое руководство. Включение пользовательского элемента управления в веб-страницу ASP.NET

  • Статья

Обновлен: Ноябрь 2007

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

Включение пользовательского элемента управления в страницу веб-форм

  1. В содержащей его веб-странице ASP.NET создайте директиву @ Register, включающую:

    • Атрибут TagPrefix, связывающий префикс с пользовательским элементом управления. Префикс включается в открывающий тег элемента пользовательского элемента управления.

    • Атрибут TagName, связывающий имя с пользовательским элементом управления. Имя включается в открывающий тег элемента пользовательского элемента управления.

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

      sbz9etab.alert_note(ru-ru,VS.90).gifПримечание.

      Значением атрибута Src может быть относительный или абсолютный путь к исходному файлу пользовательского элемента управления, задаваемый относительно корневого каталога приложения. Для обеспечения гибкости рекомендуется использовать относительный путь. Тильда (~) представляет корневой каталог приложения. Пользовательские элементы управления не могут располагаться в каталоге App_Code.

  2. В основной части веб-страницы объявите элемент пользовательского элемента управления внутри элемента form.

  3. При необходимости, если пользовательский элемент предоставляет доступ к открытым свойствам, задайте свойства декларативно.

Пример

В следующем примере показана веб-страница ASP.NET, содержащая пользовательский элемент управления. Пользовательский элемент управления располагается в файле Spinner.ascx в папке Controls. На странице элемент управления зарегистрирован на использование префикса uc и имени тега Spinner. Свойства MinValue и MaxValue пользовательского элемента управления заданы декларативно.

sbz9etab.alert_note(ru-ru,VS.90).gifПримечание.

Подробные сведения о коде, использованном в пользовательском элементе управления, см. в разделе Практическое руководство. Создание пользовательских элементов управления ASP.NET.

 
<%@ Page Language="VB" %>
<%@ Register TagPrefix="uc" TagName="Spinner" 
    Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form runat="server">
    <uc:Spinner id="Spinner1" 
        runat="server" 
        MinValue="1" 
        MaxValue="10" />
</form>
</body>

<%@ Page Language="C#" %>
<%@ Register TagPrefix="uc" TagName="Spinner" 
    Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form runat="server">
    <uc:Spinner id="Spinner1" 
        runat="server" 
        MinValue="1" 
        MaxValue="10" />
</form>
</body>

См. также

Основные понятия

Общие сведения о пользовательских элементах управления ASP.NET

Создание пользовательских элементов управления ASP.NET Roadmap