<QualifyAssembly Element (Elemento qualifyAssembly> )

Artigo
05/10/2023

Especifica o nome completo da assemblagem que deve ser carregado dinamicamente quando é utilizado um nome parcial.

<configuração>
  <runtime>
    <assemblyBinding>
      <qualifyAssembly>

Syntax

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

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo	Descrição
`partialName`	Atributo obrigatório. Especifica o nome parcial da assemblagem tal como aparece no código.
`fullName`	Atributo obrigatório. Especifica o nome completo da assemblagem tal como aparece na cache de assemblagem global.

Elementos Subordinados

Nenhum.

Elementos Principais

Elemento	Descrição
`assemblyBinding`	Contém informações sobre o redirecionamento da versão de assemblagem e as localizações das assemblagens.
`configuration`	O elemento raiz em cada ficheiro de configuração utilizado pelo runtime de linguagem comum e .NET Framework aplicações.
`runtime`	Contém informações sobre o enlace de montagem e a libertação da memória.

Observações

Chamar o Assembly.Load método com nomes de assemblagem parciais faz com que o runtime de linguagem comum procure a assemblagem apenas no diretório base da aplicação. Utilize o <elemento qualifyAssembly> no ficheiro de configuração da aplicação para fornecer as informações de assemblagem completas (nome, versão, token de chave pública e cultura) e faça com que o runtime de linguagem comum procure a assemblagem na cache de assemblagem global.

O atributo fullName tem de incluir os quatro campos da identidade de assemblagem: nome, versão, token de chave pública e cultura. O atributo partialName tem de referenciar parcialmente uma assemblagem. Tem de especificar, pelo menos, o nome do texto da assemblagem (o caso mais comum), mas também pode incluir a versão, o token de chave pública ou a cultura (ou qualquer combinação dos quatro, mas não dos quatro). O partialName tem de corresponder ao nome especificado na sua chamada. Por exemplo, não pode especificar "math" como o atributo partialName no ficheiro de configuração e chamar Assembly.Load("math, Version=3.3.3.3") no seu código.

Exemplo

O exemplo seguinte 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>

Partilhar via