Compartir a través de


Elemento <qualifyAssembly>

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

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

<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 requerido.

Especifica el nombre parcial del ensamblado tal y como aparece en el código.

fullName

Atributo requerido.

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

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

Es el 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.

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é de ensamblados global.

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

Conceptos

Cómo el motor en tiempo de ejecución ubica ensamblados
Referencias parciales a ensamblados