Elemento <assemblyIdentity> para <runtime>

Artículo
05/09/2023

Contiene información de identificación sobre el ensamblado.

<configuration>
  <runtime>
    <assemblyBinding>
      <dependentAssembly>
        <assemblyIdentity>

Sintaxis

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

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
`name`	Atributo necesario. Nombre del ensamblado.
`culture`	Atributo opcional. Cadena que especifica el idioma y el país o región del ensamblado.
`publicKeyToken`	Atributo opcional. Valor hexadecimal que especifica el nombre seguro del ensamblado.
`processorArchitecture`	Atributo opcional. Uno de los valores "x86", "amd64", "msil" o "ia64", que especifican la arquitectura del procesador para un ensamblado que contiene código específico del procesador. Los valores no distinguen mayúsculas de minúsculas. Si el atributo se asigna a cualquier otro valor, se omite todo el elemento `<assemblyIdentity>`. Vea ProcessorArchitecture.

Atributo processorArchitecture

Valor	Descripción
`amd64`	Solo arquitectura AMD x86-64.
`ia64`	Solo arquitectura Intel Itanium.
`msil`	Neutral respecto al procesador y los bits por palabra.
`x86`	Un procesador Intel x86 de 32 bits, ya sea nativo o en el entorno Windows on Windows en (WOW) en una plataforma de 64 bits.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
`assemblyBinding`	Contiene información sobre la redirección de versiones de ensamblado y las ubicaciones de ensamblados.
`configuration`	Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.
`dependentAssembly`	Encapsula la directiva de enlace y la ubicación de cada ensamblado. Use un elemento `<dependentAssembly>` para cada ensamblado.
`runtime`	Contiene información del enlace del ensamblado y de la recolección de elementos no utilizados.

Comentarios

Cada elemento <dependentAssembly> debe tener un elemento secundario <assemblyIdentity>.

Si el atributo processorArchitecture está presente, el elemento <assemblyIdentity> solo se aplica al ensamblado con la arquitectura del procesador correspondiente. Si el atributo processorArchitecture no está presente, el elemento <assemblyIdentity> puede aplicarse a un ensamblado con cualquier arquitectura de procesador.

En el ejemplo siguiente se muestra un archivo de configuración para dos ensamblados con el mismo nombre que tienen como destino dos arquitecturas de procesador diferentes y cuyas versiones no se han mantenido sincronizadas. Cuando la aplicación se ejecuta en la plataforma x86, se aplica el primer elemento <assemblyIdentity> y se omite el otro. Si la aplicación se ejecuta en una plataforma distinta de x86 o ia64, ambos se omiten.

<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>

Si un archivo de configuración contiene un elemento <assemblyIdentity> sin atributo processorArchitecture y no contiene un elemento que coincida con la plataforma, se usa el elemento sin el atributo processorArchitecture.

Ejemplo

En el ejemplo siguiente se muestra cómo proporcionar información sobre un ensamblado.

<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>

Compartir a través de