Registro de un ensamblado en un WebForm para usar un control personalizado

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

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

Propiedades de ensamblado de ejemplo

Para representarse como un control de servidor personalizado, el ensamblado debe tener una clase de System.Web.UI.Control la que deriva directa o indirectamente y debe incluir la clase en un espacio de nombres. En los ejemplos de este artículo se supone que la clase se incluye en el CustomControlNamespace espacio de nombres y que el ensamblado se ha compilado correctamente en un archivo denominado CustomControl.dll.

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

Para que un ensamblado esté disponible para una aplicación de 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 el Explorador de Windows.

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

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

   En el panel de árbol, verá la lista con la propiedad Carpeta del proyecto . 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 del directorio raíz de la aplicación (o cualquiera de sus subcarpetas).

Registro del ensamblado en un formulario web de aplicación ASP.NET

En un entorno de programación de .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 a los nombres adecuados para el ensamblado.

Ahora el ensamblado está registrado en un formulario web. Puede usar este ensamblado registrado en el código de 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, Custom es el nombre elegido para el espacio de nombres del ensamblado, CustomControl es el nombre del control de servidor personalizado y parameter 1parameter2 son propiedades de control opcionales que varían en función del código real.