<assemblyBinding> (Elemento) para <runtime>

  • Artículo

Actualización: noviembre 2007

Contiene información sobre la redirección de versiones de ensamblado y las ubicaciones de ensamblados.

<configuration> (Elemento)
  Elemento <runtime>
    <assemblyBinding> (Elemento) para <runtime>

<assemblyBinding  
   xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
</assemblyBinding>

Atributos y elementos

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

Atributos

Atributo

Descripción

xmlns

Atributo requerido.

Especifica el espacio de nombres XML que requiere el enlace del ensamblado. Utilice la cadena "urn:schemas-microsoft-com:asm.v1" como el valor de este atributo.

appliesTo

Especifica la versión del motor en tiempo de ejecución a la que se aplica la redirección del ensamblado de .NET Framework. Este atributo opcional utiliza un número de versión de .NET Framework para indicar la versión a la que se aplica. Si se especifica el atributo appliesTo, el elemento <assemblyBinding> se aplica a todas las versiones de .NET Framework. El atributo appliesTo apareció por primera vez en la versión 1.1 de .NET Framework; la versión 1.0 de .NET Framework pasa por alto este atributo. Esto significa que se aplican todos los elementos <assemblyBinding> cuando se utiliza la versión 1.0 de .NET Framework, aunque se especifique un atributo appliesTo.

Elementos secundarios

Elemento

Descripción

<dependentAssembly>

Encapsula la directiva de enlace y la ubicación de un ensamblado. Utilice una etiqueta <dependentAssembly> para cada ensamblado.

<probing>

Especifica los subdirectorios en los que busca Common Language Runtime cuando se cargan los ensamblados.

<publisherPolicy>

Especifica si el motor de ejecución aplica la directiva de editor.

<qualifyAssembly>

Especifica el nombre completo del ensamblado que debe cargarse dinámicamente cuando se utiliza un nombre parcial.

Elementos primarios

Elemento

Descripción

configuration

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

runtime

Contiene información del enlace del ensamblado y del recolector de elementos no utilizados.

Ejemplo

En el siguiente ejemplo se muestra cómo redirigir una versión de ensamblado a otra versión y cómo proporcionar un código base.

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

En el ejemplo siguiente se muestra cómo usar el atributo appliesTo para redirigir el enlace de un ensamblado de .NET Framework.

<runtime>
   <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
      <dependentAssembly> 
         <assemblyIdentity name="mscorcfg" publicKeyToken="b03f5f7f11d50a3a" culture=""/>
         <bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="1.0.3300.0"/>
      </dependentAssembly>
   </assemblyBinding>
</runtime>

Vea también

Conceptos

Redirigir versiones de ensamblado

Referencia

Esquema de la configuración de Common Language Runtime

Otros recursos

Esquema de los archivos de configuración de .NET Framework