Elemento <qualifyAssembly>

  • Artículo

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

<configuration>
  <runtime>
    <assemblyBinding>
      <qualifyAssembly>

Sintaxis

      <qualifyAssembly partialName=  
      "PartialAssemblyName"  
                 fullName="FullAssemblyName"/>

Atributos y elementos

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

Atributos

Atributo Descripción
partialName Atributo necesario.

Especifica el nombre parcial del ensamblado tal como aparece en el código.
fullName Atributo necesario.

Especifica el nombre completo del ensamblado tal como aparece en la caché global de ensamblados.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento Descripción
assemblyBinding Contiene información sobre la redirección de versiones de ensamblado y las ubicaciones de ensamblados.
configuration Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.
runtime Contiene información del enlace del ensamblado y de la recolección de elementos no utilizados.

Comentarios

Llamar al método Assembly.Load mediante nombres de ensamblado parciales hace que Common Language Runtime busque el ensamblado solo en el directorio base de la aplicación. Use el elemento <qualifyAssembly> en su archivo de configuración de la aplicación para proporcionar la información completa del ensamblado (nombre, versión, token de clave pública y referencia cultural) y hacer que Common Language Runtime busque el ensamblado en la caché global de ensamblados.

El atributo fullName debe incluir los cuatro campos de identidad del ensamblado: nombre, versión, token de clave pública y referencia cultural. El atributo partialName debe hacer referencia parcial a un ensamblado. Debe especificar al menos el nombre de texto del ensamblado (el caso más común), pero también puede incluir la versión, el token de clave pública o la referencia cultural (o cualquier combinación de los cuatro, pero no los cuatro). PartialName debe coincidir con el nombre especificado en la llamada. Por ejemplo, no puede especificar "math" como el atributo partialName en el archivo de configuración y llamar a Assembly.Load("math, Version=3.3.3.3") en el código.

Ejemplo

En el ejemplo siguiente se convierte lógicamente la llamada Assembly.Load("math") en Assembly.Load("math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral").

<configuration>  
   <runtime>  
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
         <qualifyAssembly partialName="math"
                         fullName=  
"math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral"/>  
      </assemblyBinding>  
   </runtime>  
</configuration>

Consulte también