Elemento <qualifyAssembly>

Artigo
05/10/2023

Especifica o nome completo do assembly que deve ser carregado dinamicamente quando um nome parcial é usado.

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

Syntax

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo	Descrição
`partialName`	Atributo obrigatório. Especifica o nome parcial do assembly como ele aparece no código.
`fullName`	Atributo obrigatório. Especifica o nome completo do assembly como ele aparece no cache de assembly global.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
`assemblyBinding`	Contém informações sobre o redirecionamento de versão e os locais dos assemblies.
`configuration`	O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.
`runtime`	Contém informações sobre associação do assembly e coleta de lixo.

Comentários

Chamar o método Assembly.Load usando nomes de assembly parciais faz com que o Common Language Runtime procure o assembly somente no diretório base do aplicativo. Use o elemento <qualifyAssembly> no arquivo de configuração do aplicativo para fornecer as informações completas do assembly (nome, versão, token de chave pública e cultura) e fazer com que o Common Language Runtime pesquise o assembly no cache de assembly global.

O atributo fullName deve incluir os quatro campos de identidade de assembly: nome, versão, token de chave pública e cultura. O atributo partialName deve referenciar parcialmente um assembly. Você deve especificar pelo menos o nome de texto do assembly (o caso mais comum), mas também pode incluir versão, token de chave pública ou cultura (ou qualquer combinação dos quatro, mas não todos os quatro). O partialName deve corresponder ao nome especificado em sua chamada. Por exemplo, você não pode especificar "math" como o atributo partialName em seu arquivo de configuração e chamar Assembly.Load("math, Version=3.3.3.3") em seu código.

Exemplo

O exemplo a seguir transforma logicamente a chamada Assembly.Load("math") em 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>

Compartilhar via