Compartir a través de


Clase System.Resources.SatelliteContractVersionAttribute

En este artículo se proporcionan comentarios adicionales a la documentación de referencia de esta API.

En las aplicaciones de escritorio, el SatelliteContractVersionAttribute atributo establece un contrato entre un ensamblado principal y todos sus satélites. Este atributo se aplica al ensamblado principal y se pasa el número de versión de los ensamblados satélite que funcionarán con esta versión del ensamblado principal. Cuando el administrador de recursos (ResourceManager objeto) busca recursos, carga explícitamente la versión satélite especificada por este atributo en el ensamblado principal.

Al actualizar el ensamblado principal, se incrementa su número de versión del ensamblado. Sin embargo, es posible que no quiera enviar nuevas copias de los ensamblados satélite si las existentes son compatibles con la aplicación. En este caso, incremente el número de versión del ensamblado principal, pero deje el número de versión del contrato satélite igual. El administrador de recursos usará los ensamblados satélite existentes.

Si desea revisar un ensamblado satélite pero no el ensamblado principal, incremente el número de versión en el satélite. En este caso, envíe un ensamblado de directiva de publicador junto con el ensamblado satélite que indica que el nuevo ensamblado satélite tiene compatibilidad con versiones anteriores con el ensamblado satélite antiguo. El administrador de recursos seguirá usando el número de contrato anterior escrito en el ensamblado principal basado en el SatelliteContractVersionAttribute atributo ; sin embargo, el cargador se enlazará a la versión del ensamblado satélite especificada por el ensamblado de directiva.

Un proveedor de un componente compartido usa un ensamblado de directiva de publicador para realizar una declaración de compatibilidad sobre una versión determinada de un ensamblado publicado. Un ensamblado de directiva de publicador es un ensamblado con nombre seguro que tiene un nombre en el formato policy.<major>.<minor>.<ComponentAssemblyName>y se registra en la caché global de ensamblados (GAC). La directiva de publicador se genera a partir de un archivo de configuración XML (vea el <elemento bindingRedirect>) mediante la herramienta Al.exe (Assembly Linker). Assembly Linker se usa con la /link opción de vincular el archivo de configuración XML a un ensamblado de manifiesto, que luego se almacena en la caché global de ensamblados. Los ensamblados de directiva de publicador se pueden usar cuando un proveedor envía una versión de mantenimiento (Service Pack) que contiene correcciones de errores.

Aplicaciones de la Tienda Windows 8.x

Este atributo se omite en las aplicaciones de la Tienda Windows 8.x, ya que los archivos de índice de recursos de paquete (PRI) no tienen semántica de control de versiones. Además, el modelo de empaquetado de la Tienda Windows 8.x requiere que todos los recursos se envíen en el mismo paquete, sin posibilidad de volver a implementar ensamblados satélite o archivos PRI.