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

  • Статья

В этой статье содержатся сведения о том, как сделать сборку доступной в WebForm и зарегистрировать ее для использования с ASP.NET пользовательскими серверными элементами управления.

Исходная версия продукта: ASP.NET
Исходный номер базы знаний: 321749

Пример свойств сборки

Чтобы быть представлена в виде пользовательского серверного элемента управления, сборка должна иметь класс, который прямо или косвенно является производным от System.Web.UI.Control , и необходимо заключить класс в пространство имен. В примерах в этой статье предполагается, что класс заключен в CustomControlNamespace пространство имен и что сборка успешно скомпилирована в файл с именем CustomControl.dll.

Сделать сборку доступной для ASP.NET приложения

Чтобы сделать сборку доступной для приложения ASP.NET, необходимо поместить .dll сборки в папку /bin приложения.

  1. Перейдите в корневой каталог приложения в Windows Обозреватель.

    Чтобы узнать, что такое папка проекта приложения, выполните следующие действия:

    1. В среде .NET в меню Вид выберите Обозреватель решений.
    2. Щелкните правой кнопкой мыши проект main элемент в Обозреватель решений и выберите Пункт Свойства.
    3. В диалоговом окне Свойства проекта выберите Общие свойства и общие.

    В области дерева отобразится список со свойством Папка проекта . Обычно это корневой каталог приложения.

  2. В папке проекта веб-приложения создайте папку с именем bin , если она не существует.

  3. Скопируйте или переместите .dll сборки в эту папку. Теперь вы можете использовать элемент управления из любой ASP.NET страницы в корневом каталоге приложения (или любой из его вложенных папок).

Регистрация сборки в веб-форме приложения ASP.NET

В среде программирования .NET откройте окно исходного кода Form.aspx и добавьте следующий тег в начало кода:

<%@ Register TagPrefix="Custom" Namespace="CustomControlNamespace" Assembly= "CustomControl" %>

В коде выше:

  • Custom — это псевдоним, связанный с пространством имен.
  • CustomControlNamespace — это пространство имен, в которое заключены классы сборки.
  • CustomControl — это имя файла сборки без расширения (.dll).

В коде измените эти параметры на соответствующие имена для сборки.

Теперь сборка зарегистрирована в веб-форме. Эту зарегистрированную сборку можно использовать в коде ASP.NET с выбранными именами. Например, тег может быть следующим:

<Custom:CustomControl id="CustomControl1" parameter1="value1" parameter2="value2" runat="server"/>

В теге выше Custom — выбранное имя для пространства имен сборки, CustomControl пользовательское имя серверного элемента управления и parameter 1parameter2 необязательные свойства элемента управления, которые зависят от фактического кода.