Partilhar via


<qualifyAssembly> Elemento

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

<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 global de assemblies.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

assemblyBinding

Contém informações sobre o redirecionamento de versão do assembly e os locais de assemblies.

configuration

O elemento raiz em cada arquivo de configuração usadas pelos common language runtime e .NET Framework aplicativos.

runtime

Contém informações sobre o assembly ligação e coleta de lixo.

Comentários

Chamar o Assembly.Load método usando nomes assembly parciais faz com que o common language runtime procurar o assembly apenas no diretório de base de aplicativo. Use o <qualifyAssembly> o elemento no seu arquivo de configuração do aplicativo para fornecer as informações de assembly completo (nome, versão, token de chave pública e cultura) e fazer com que o common language runtime procurar o assembly no cache global de assemblies.

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

Exemplo

O exemplo a seguir ativa o 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

Referência

Esquema configurações Runtime

Conceitos

Como o Runtime Localiza Assemblies

Referências de Assembly parcial