@ Assembly

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

Vincula un ensamblado a un archivo de aplicación ASP.NET (como una página Web, un control de usuario, una página maestra o un archivo Global.asax) durante la compilación, de modo que todas las clases e interfaces del ensamblado queden disponibles para ser utilizadas.

<%@ Assembly Name="assemblyname" %>
<%@ Assembly Src="pathname" %>

Atributos

  • Name
    Cadena que representa el nombre del ensamblado que se va a vincular.

    Nota

    El nombre del ensamblado no incluye la extensión del archivo.

  • Src
    Ruta de acceso al archivo de código fuente que se compila y vincula dinámicamente.

    Nota

    Es preciso incluir un atributo Name o Src en una directiva @ Assembly, pero no se pueden incluir ambos en la misma directiva.Si se necesita usar ambos atributos, se deben incluir varias directivas @ Assembly en el archivo.

Comentarios

El compilador hace referencia al ensamblado en tiempo de compilación para permitir el enlace en tiempo de compilación. Una vez realizada la compilación del archivo ASP.NET solicitado, se carga el ensamblado en el dominio de aplicación para permitir el enlace en tiempo de ejecución. La directiva @ Assembly puede usarse en páginas .aspx, archivos .ascx, páginas .master y archivos .asax.

Los ensamblados que residen en el directorio \Bin de una aplicación Web se vinculan automáticamente a los archivos ASP.NET de dicha aplicación. Esos ensamblados no requieren la directiva @ Assembly. Es posible deshabilitar esta funcionalidad quitando la siguiente línea de la sección <assemblies> del archivo Web.config de la aplicación:

<add assembly="*"/>

Como alternativa al uso de la directiva @ Assembly, se puede utilizar el archivo Web.config para vincular ensamblados en toda una aplicación. Para obtener más información sobre el archivo Web.config y sobre cómo configurar la aplicación, vea ASP.NET Configuration Overview y Elemento assemblies para compilation (Esquema de configuración de ASP.NET).

Ejemplo

En el siguiente ejemplo de código se utilizan dos directivas @ Assembly; la primera se utiliza para vincular a un ensamblado definido por el usuario, MyAssembly, y la segunda para vincular a un archivo de código fuente de Visual Basic, MySource.vb.

<%@ Assembly Name="MyAssembly" %>
<%@ Assembly Src="MySource.vb" %>

Vea también

Referencia

Sintaxis de directivas de plantilla de texto

Elemento assemblies para compilation (Esquema de configuración de ASP.NET)

Conceptos

ASP.NET Web Page Syntax Overview