Compartir vía

Elemento <codeBase>

  • Artículo

Especifica dónde puede Common Language Runtime encontrar un ensamblado.

<configuration>
  <runtime>
    <assemblyBinding>
      <dependentAssembly>
        <codeBase>

Sintaxis

   <codeBase
        version="Assembly version"
        href="URL of assembly"/>

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo Descripción
href Atributo necesario.

Especifica la dirección URL donde el runtime puede encontrar la versión especificada del ensamblado.
version Atributo necesario.

Especifica la versión del ensamblado a la que se aplica el código base. El formato de un número de versión del ensamblado es major.minor.build.revision.

versión Attribute

Valor Descripción
Los valores válidos para cada una de las partes del número de versión van del 0 al 65535. No aplicable.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento Descripción
buildproviders Define una colección de proveedores de generación que se utiliza para compilar archivos de recursos personalizados. Puede tener cualquier número de proveedores de generación.
compilation Configura todos los valores de compilación que usa ASP.NET.
configuration Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.
System.web Especifica el elemento raíz de la sección de configuración de ASP.NET.

Comentarios

Para que el runtime use la configuración <codeBase> en un archivo de configuración de máquina o en un archivo de directiva de publicador, el archivo también debe redirigir la versión del ensamblado. Los archivos de configuración de la aplicación pueden tener una valor de código base sin redirigir la versión del ensamblado. Después de determinar la versión del ensamblado que se va a usar, el runtime aplica la configuración de código base del archivo que determina la versión. Si no se indica ningún código base, el runtime sondea el ensamblado de la manera habitual.

Si el ensamblado tiene un nombre seguro, la configuración de código base puede estar en cualquier parte de la intranet local o en Internet. Si el ensamblado es un ensamblado privado, el valor de código base debe ser una ruta de acceso relativa al directorio de la aplicación.

En el caso de los ensamblados sin un nombre seguro, se omite la versión y el cargador usa la primera apariencia del <código base> dentro de <dependentAssembly>. Si hay una entrada en el archivo de configuración de la aplicación que redirige el enlace a otro ensamblado, el redireccionamiento tendrá prioridad incluso si la versión del ensamblado no coincide con la solicitud de enlace.

Ejemplo

En el ejemplo siguiente se muestra cómo especificar dónde puede el runtime encontrar un ensamblado.

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <dependentAssembly>
            <assemblyIdentity name="myAssembly"
                              publicKeyToken="32ab4ba45e0a69a1"
                              culture="neutral" />
            <codeBase version="2.0.0.0"
                      href="http://www.litwareinc.com/myAssembly.dll"/>
         </dependentAssembly>
      </assemblyBinding>
   </runtime>
</configuration>

Consulte también