<qualifyAssembly > elemento<qualifyAssembly> Element

Especifica el nombre completo del ensamblado que debe cargarse dinámicamente cuando se utiliza un nombre parcial.Specifies the full name of the assembly that should be dynamically loaded when a partial name is used.

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

SintaxisSyntax

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

Atributos y elementosAttributes and Elements

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DescripciónDescription
partialName Atributo necesario.Required attribute.

Especifica el nombre parcial del ensamblado tal como aparece en el código.Specifies the partial name of the assembly as it appears in the code.
fullName Atributo necesario.Required attribute.

Especifica el nombre completo del ensamblado tal como aparece en la caché global de ensamblados.Specifies the full name of the assembly as it appears in the global assembly cache.

Elementos secundariosChild Elements

Ninguno.None.

Elementos primariosParent Elements

ElementoElement DescripciónDescription
assemblyBinding Contiene información sobre la redirección de versiones de ensamblado y las ubicaciones de ensamblados.Contains information about assembly version redirection and the locations of assemblies.
configuration Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
runtime Contiene información del enlace del ensamblado y de la recolección de elementos no utilizados.Contains information about assembly binding and garbage collection.

ComentariosRemarks

Una llamada a la Assembly.Load método utilizando nombres de ensamblado parciales hace que common language runtime que se busca el ensamblado sólo en el directorio de base de la aplicación.Calling the Assembly.Load method using partial assembly names causes the common language runtime to look for the assembly only in the application base directory. Use la <qualifyAssembly > elemento en el archivo de configuración de aplicación para proporcionar la información de ensamblado completo (nombre, versión, referencia cultural y token de clave pública) y hacer que common language runtime buscar para el ensamblado en la caché global de ensamblados.Use the <qualifyAssembly> element in your application configuration file to provide the full assembly information (name, version, public key token, and culture) and cause the common language runtime to search for the assembly in the global assembly cache.

El fullName atributo debe incluir los cuatro campos de identidad del ensamblado: nombre, versión, referencia cultural y token de clave pública.The fullName attribute must include the four fields of assembly identity: name, version, public key token, and culture. El partialName atributo parcialmente debe hacer referencia a un ensamblado.The partialName attribute must partially reference an assembly. Debe especificar al menos el nombre del ensamblado texto (el caso más común), pero también puede incluir versión, token de clave pública, o referencia cultural (o cualquier combinación de los cuatro, pero no los cuatro).You must specify at least the assembly's text name (the most common case), but you can also include version, public key token, or culture (or any combination of the four, but not all four). El partialName debe coincidir con el nombre especificado en la llamada.The partialName must match the name specified in your call. Por ejemplo, no se puede especificar "math" como el partialName atributo en el archivo de configuración y la llamada Assembly.Load("math, Version=3.3.3.3") en el código.For example, you cannot specify "math" as the partialName attribute in your configuration file and call Assembly.Load("math, Version=3.3.3.3") in your code.

EjemploExample

El ejemplo siguiente convierte de manera lógica la llamada Assembly.Load("math") en Assembly.Load("math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral").The following example logically turns the call Assembly.Load("math") into 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énSee also