Compartir a través de


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

Actualización: noviembre 2007

Agrega a la colección una referencia a un ensamblado.

Elemento <configuration>
  Elemento system.web (Esquema de configuración de ASP.NET)
    Elemento compilation (Esquema de configuración de ASP.NET)
      Elemento assemblies para compilation (Esquema de configuración de ASP.NET)
        Elemento add aplicado a assemblies para compilation (Esquema de configuración de ASP.NET)

<add 
   assembly="Assembly 
             [,Version=version number] 
             [,Culture=culture] 
             [,PublicKeyToken=token]"
/>

Atributos y elementos

Las secciones siguientes describen los atributos, los elementos secundarios y los elementos primarios..

Atributos

Atributo

Descripción

assembly

Atributo String requerido.

Especifica una combinación de ensamblado que indica la versión, la referencia cultural y la clave pública, separadas por comas. ASP.NET busca primero el archivo DLL del ensamblado en el directorio Bin privado de la aplicación y, a continuación, en la caché de ensamblados del sistema.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento

Descripción

configuration

Elemento raíz de cada archivo de configuración usado por Common Language Runtime y las aplicaciones .NET Framework.

system.web

Especifica el elemento raíz de la sección de configuración de ASP.NET.

compilation

Configura todas las opciones de compilación que utiliza ASP.NET para compilar aplicaciones.

assemblies

Define una colección de nombres de ensamblados que se usan durante la compilación de una aplicación ASP.NET.

Comentarios

El elemento add agrega una referencia a un ensamblado para utilizarla en la compilación de un recurso dinámico. ASP.NET vincula automáticamente el ensamblado al recurso cuando compila cada módulo de código.

El valor del elemento add es un nombre de ensamblado, no la ruta de acceso de una DLL. ASP.NET busca el nombre del ensamblado para determinar su ubicación física en una DLL. Opcionalmente, puede especificar el carácter comodín asterisco (*) para agregar todos los ensamblados de la caché de ensamblados propia de una aplicación, que se encuentra en el subdirectorio \bin de la aplicación o en el directorio de instalación de .NET Framework (%systemroot%\Microsoft.NET\Framework\versión\). Para obtener información detallada, vea Load.

Configuración predeterminada

El siguiente elemento assemblies predeterminado se configura en el archivo Web.config raíz.

<assemblies>
    <add assembly="mscorlib" />
    <add assembly="System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
    <add assembly="System.Configuration, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    <add assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    <add assembly="System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
    <add assembly="System.Web.Services, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    <add assembly="System.Xml, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
    <add assembly="System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    <add assembly="System.EnterpriseServices, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    <add assembly="System.Web.Mobile, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    <add assembly="*" />
</assemblies>

Ejemplo

En el siguiente ejemplo de código se muestra cómo agregar la referencia de un ensamblado a una aplicación.

<configuration>
   <system.web>
      <compilation>
         <assemblies>
            <add assembly="System.Data, Version=1.0.2411.0, 
                           Culture=neutral, 
                           PublicKeyToken=b77a5c561934e089"/>
         </assemblies>
      </compilation>
   </system.web>
</configuration>

Información de elemento

Controlador de la sección de configuración

CompilationSection

Miembro de configuración

Add

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Web.config del nivel de directorio virtual o físico

Requisitos   

Microsoft Internet Information Services (IIS) versión 5.0, 5.1 ó 6.0

.NET Framework versión 1.0, 1.1 ó 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

Cómo: Configurar directorios concretos mediante la configuración de la ubicación

Cómo: Bloquear los valores de configuración de ASP.NET

Conceptos

Información general sobre la compilación de ASP.NET

Información general sobre sintaxis de páginas web ASP.NET

Jerarquía de archivos y herencia de la configuración de ASP.NET

Proteger la configuración de ASP.NET

Escenarios de configuración de ASP.NET

Referencia

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

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

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

Elemento configuration (Esquema de configuración general)

Elemento system.web (Esquema de configuración de ASP.NET)

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

CompilationSection

System.Configuration

System.Web.Configuration

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Administrar sitios web ASP.NET

Archivos de configuración de ASP.NET

API de configuración de ASP.NET