Регистрация сборки в WebForm для использования пользовательского элемента управления
В этой статье содержатся сведения о том, как сделать сборку доступной в WebForm и зарегистрировать ее для использования с ASP.NET пользовательскими серверными элементами управления.
Исходная версия продукта: ASP.NET
Исходный номер базы знаний: 321749
Пример свойств сборки
Чтобы быть представлена в виде пользовательского серверного элемента управления, сборка должна иметь класс, который прямо или косвенно является производным от System.Web.UI.Control
, и необходимо заключить класс в пространство имен. В примерах в этой статье предполагается, что класс заключен в CustomControlNamespace
пространство имен и что сборка успешно скомпилирована в файл с именем CustomControl.dll.
Сделать сборку доступной для ASP.NET приложения
Чтобы сделать сборку доступной для приложения ASP.NET, необходимо поместить .dll сборки в папку /bin
приложения.
Перейдите в корневой каталог приложения в Windows Обозреватель.
Чтобы узнать, что такое папка проекта приложения, выполните следующие действия:
- В среде .NET в меню Вид выберите Обозреватель решений.
- Щелкните правой кнопкой мыши проект main элемент в Обозреватель решений и выберите Пункт Свойства.
- В диалоговом окне Свойства проекта выберите Общие свойства и общие.
В области дерева отобразится список со свойством Папка проекта . Обычно это корневой каталог приложения.
В папке проекта веб-приложения создайте папку с именем bin , если она не существует.
Скопируйте или переместите .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 1
parameter2
необязательные свойства элемента управления, которые зависят от фактического кода.
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по