Elemento <qualifyAssembly>
Especifica el nombre completo del ensamblado que debe cargarse dinámicamente cuando se utiliza un nombre parcial.
<qualifyAssembly partialName="PartialAssemblyName"
fullName="FullAssemblyName"/>
Atributos y elementos
En las secciones siguientes 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 y como aparece en el código. |
fullName |
Atributo necesario. Especifica el nombre completo del ensamblado tal y como aparece 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 del recolector de elementos no utilizados. |
Comentarios
Al llamar al método Assembly.Load mediante nombres de ensamblado parciales, el motor en tiempo de ejecución buscará el ensamblado sólo en el directorio base de la aplicación. Utilice el elemento <qualifyAssembly> en el archivo de configuración de la aplicación para facilitar toda la información del ensamblado (nombre, versión, símbolo (token) de la clave pública y referencia cultural) y haga que el motor en tiempo de ejecución busque el ensamblado en la caché global de ensamblados.
El atributo fullName debe incluir los cuatro campos de la identidad del ensamblado: nombre, versión, símbolo (token) de la clave pública y referencia cultural. El atributo partialName debe hacer parcialmente referencia a un ensamblado. Se ha de especificar al menos el nombre de texto del ensamblado (caso más habitual), si bien también se puede incluir la versión, el símbolo (token) de la clave pública o la referencia cultural (o cualquier combinación de estos cuatro campos, pero no los cuatro conjuntamente). El atributo partialName debe coincidir con el nombre especificado en la llamada. Por ejemplo, no se puede especificar "math" como 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 siguiente ejemplo, se convierte de manera lógica la llamada a Assembly.Load("math") en una llamada a 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>
Vea también
Referencia
Esquema de la configuración de Common Language Runtime