Compartilhar via


<qualifyAssembly> Elemento

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

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

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 necessário.

Especifica o nome parcial do assembly como ele aparece no código.
fullName Atributo necessário.

Especifica o nome completo do assembly como ele aparece no cache de assembly global.

Elementos filho

Nenhum.

Elementos pai

Elemento Description
assemblyBinding Contém informações sobre o redirecionamento da versão do assembly 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 de assembly e coleta de lixo.

Observações

Chamar o Assembly.Load método usando nomes parciais de assembly faz com que o common language runtime procure o assembly somente no diretório base do aplicativo. Use o <qualifyAssembly> elemento 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 fullName atributo deve incluir os quatro campos de identidade do assembly: nome, versão, token de chave pública e cultura. O partialName atributo deve referenciar parcialmente um assembly. Você deve especificar pelo menos o nome do texto do assembly (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 todos os quatro). Deve partialName corresponder ao nome especificado em sua chamada. Por exemplo, você não pode especificar "math" como o partialName atributo em seu arquivo de configuração e chamar Assembly.Load("math, Version=3.3.3.3") seu código.

Example

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>

Consulte também