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

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

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

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

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo

Descripción

assembly

El atributo String es obligatorio.

Especifica una combinación de ensamblado que indica la versión, la referencia cultural y los tokens de clave pública, separados 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 1.0, 1.1 ó 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

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

Conceptos

ASP.NET Compilation Model

ASP.NET Web Page Syntax Overview

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API