Partilhar via


<qualifyAssembly> Elemento

Especifica o nome completo da assembly que deve ser carregada dinamicamente quando um nome parcial é utilizado.

<configuração>
   <tempo de execução>
     <assemblyBinding>
       <qualificaçãoAssembleia>

Sintaxe

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

Atributos e Elementos

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

Attributes

Attribute Description
partialName Atributo obrigatório.

Especifica o nome parcial do conjunto tal como aparece no código.
fullName Atributo obrigatório.

Especifica o nome completo da assembleia tal como aparece na cache global de assembly.

Elementos Subordinados

Nenhum.

Elementos Principais

Elemento Description
assemblyBinding Contém informação sobre a redireção de versões de montagem e as localizações das assembleias.
configuration O elemento raiz em cada arquivo de configuração usado pelo Common Language Runtime e aplicativos .NET Framework.
runtime Contém informações sobre encadernação de montagem e recolha de lixo.

Observações

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

O fullName atributo deve incluir os quatro campos de identidade assembly: nome, versão, token de chave pública e cultura. O partialName atributo deve referenciar parcialmente uma assembleia. Deve especificar pelo menos o nome do texto da assembleia (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). Devem partialName corresponder ao nome especificado na sua chamada. Por exemplo, não pode especificar "math" como atributo partialName no seu ficheiro de configuração e chamar Assembly.Load("math, Version=3.3.3.3") o seu código.

Example

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>

Consulte também