Registrar un ensamblado en un WebForm para usar un control personalizado

  • Artículo
  • Tiempo de lectura: 2 minutos

En este artículo se proporciona información para hacer y registrar un ensamblado disponible en un WebForm para usarlo ASP.NET controles de servidor personalizados.

Versión del producto original:   ASP.NET
Número KB original:   321749

Propiedades de ensamblado de ejemplo

Para representarse como un control de servidor personalizado, el ensamblado debe tener una clase de la que deriva directa o indirectamente y debe incluir la clase en System.Web.UI.Control un espacio de nombres. Los ejemplos de este artículo suponen que la clase está incluida en el espacio de nombres y que el ensamblado se compiló correctamente en un archivo CustomControlNamespace denominado CustomControl.dll.

Hacer que un ensamblado esté disponible para ASP.NET aplicación

Para que un ensamblado esté disponible para una ASP.NET, debe colocar el .dll del ensamblado en la /bin carpeta de la aplicación.

  1. Vaya al directorio raíz de la aplicación en Windows Explorer.

    Para averiguar cuál es la carpeta del proyecto de aplicación:

    1. En el entorno .NET, en el menú Ver, seleccione Explorador de soluciones.
    2. Haga clic con el botón secundario en un elemento principal del proyecto en el Explorador de soluciones y seleccione Propiedades.
    3. En el cuadro Project propiedades, seleccione Propiedades comunes y seleccione General.

    En el panel de árbol, verá la lista con la Project Folder. Normalmente, este es el directorio raíz de la aplicación.

  2. En una carpeta de proyecto de aplicación web, cree una carpeta denominada bin si no existe.

  3. Copie o mueva el .dll del ensamblado en esta carpeta. Ahora puede usar el control desde cualquier página ASP.NET en el directorio raíz de la aplicación (o cualquiera de sus subcarpetas).

Registrar el ensamblado en un formulario ASP.NET web de la aplicación

En un entorno de programación .NET, abra la ventana de origen Form.aspx y agregue la siguiente etiqueta en la parte superior del código:

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

En el código anterior:

  • Custom es un alias que se asocia a un espacio de nombres.
  • CustomControlNamespace es un espacio de nombres en el que se incluyen las clases de un ensamblado.
  • CustomControl es el nombre del archivo de ensamblado sin una extensión (.dll).

En el código, cambie estos parámetros por los nombres adecuados para el ensamblado.

Ahora, el ensamblado está registrado en un formulario web. Puede usar este ensamblado registrado en el código ASP.NET con los nombres elegidos. Por ejemplo, la etiqueta podría ser:

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

En la etiqueta anterior, es el nombre elegido para el espacio de nombres del ensamblado, es el nombre del control de servidor personalizado y son propiedades de control opcionales que varían en función del Custom CustomControl código parameter 1 parameter2 real.