<Elemento assemblyIdentity> para <runtime>

Artigo
05/09/2023

Contém informações de identificação sobre o assembly.

<configuração>
  <runtime>
    <assemblyBinding>
      <dependentAssembly>
        <assemblyIdentity>

Syntax

   <assemblyIdentity
name="assembly name"  
publicKeyToken="public key token"  
culture="assembly culture"/>

Atributos e elementos

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

Atributos

Atributo	Descrição
`name`	Atributo obrigatório. O nome do assembly
`culture`	Atributo opcional. Uma cadeia de caracteres que especifica o idioma e o país/região do assembly.
`publicKeyToken`	Atributo opcional. Um valor hexadecimal que especifica o nome compartilhado do assembly.
`processorArchitecture`	Atributo opcional. Um dos valores "x86", "amd64", "msil" ou "ia64", especificando a arquitetura do processador para um assembly que contém código específico do processador. Os valores não diferenciam maiúsculas de minúsculas. Se o atributo for atribuído a qualquer outro valor, todo o elemento `<assemblyIdentity>` será ignorado. Consulte ProcessorArchitecture.

Atributo processorArchitecture

Valor	Descrição
`amd64`	Somente arquitetura AMD x86-64.
`ia64`	Somente arquitetura do Intel Itanium.
`msil`	Neutro em relação ao processador e bits por palavra.
`x86`	Um processador x86 de 32 bits, nativo ou no ambiente Windows on Windows (WOW) em uma plataforma de 64 bits.

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.
`dependentAssembly`	Encapsula local do assembly e política de associação para cada assembly. Use um elemento `<dependentAssembly>` para cada assembly.
`runtime`	Contém informações sobre associação do assembly e coleta de lixo.

Comentários

Cada elemento <dependentAssembly> deve ter um elemento filho <assemblyIdentity>.

Se o atributo processorArchitecture estiver presente, o elemento <assemblyIdentity> se aplica apenas ao assembly com a arquitetura de processador correspondente. Se o atributo processorArchitecture não estiver presente, o elemento <assemblyIdentity> pode ser aplicado a um assembly com qualquer arquitetura de processador.

O exemplo a seguir mostra um arquivo de configuração para dois assemblies com o mesmo nome que visam duas arquiteturas de processador diferentes e cujas versões não foram mantidas em sincronia. Quando o aplicativo é executado na plataforma x86, o primeiro elemento <assemblyIdentity> se aplica e o outro é ignorado. Se o aplicativo for executado em uma plataforma diferente de x86 ou ia64, ambos serão ignorados.

<configuration>  
   <runtime>  
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
         <dependentAssembly>  
            <assemblyIdentity name="MyAssembly"  
                  publicKeyToken="14a739be0244c389"  
                  culture="neutral"  
                  processorArchitecture="x86" />  
            <bindingRedirect oldVersion= "1.0.0.0"
                  newVersion="1.1.0.0" />  
         </dependentAssembly>  
         <dependentAssembly>  
            <assemblyIdentity name="MyAssembly"  
                  publicKeyToken="14a739be0244c389"  
                  culture="neutral"
                  processorArchitecture="ia64" />  
            <bindingRedirect oldVersion="1.0.0.0"
                  newVersion="2.0.0.0" />  
         </dependentAssembly>  
      </assemblyBinding>  
   </runtime>  
</configuration>

Se um arquivo de configuração contiver um elemento <assemblyIdentity> sem atributo processorArchitecture e não contiver um elemento que corresponda à plataforma, o elemento sem o atributo processorArchitecture será usado.

Exemplo

O exemplo a seguir mostra como fornecer informações sobre um assembly.

<configuration>  
   <runtime>  
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
         <dependentAssembly>  
            <assemblyIdentity name="myAssembly"  
                              publicKeyToken="32ab4ba45e0a69a1"  
                              culture="neutral" />  
            <!--Redirection and codeBase policy for myAssembly.-->  
         </dependentAssembly>  
      </assemblyBinding>  
   </runtime>  
</configuration>

Compartilhar via