Elemento <qualifyAssembly>
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>