Número de versión de los ensamblados principales y los ensamblados satélite localizados
La clase SatelliteContractVersionAttribute proporciona compatibilidad de versiones para un ensamblado principal que utiliza recursos localizados mediante un administrador de recursos.Aplicar el atributo SatelliteContractVersionAttribute al ensamblado principal de una aplicación permite actualizar y volver a implementar el ensamblado sin necesidad de actualizar sus ensamblados satélite.Por ejemplo, se puede utilizar la clase SatelliteContractVersionAttribute con un Service Pack que no introduce nuevos recursos sin recompilar e implementar los ensamblados satélite.Para que estén disponibles los recursos localizados, la versión de contrato satélite del ensamblado principal debe coincidir con la clase AssemblyVersionAttribute de los ensamblados satélite.Debe especificar un número de versión exacto en el SatelliteContractVersionAttribute; no se permiten caracteres comodín como "*".Para obtener más información, vea Recuperar recursos de aplicaciones de escritorio.
Actualizar ensamblados
La clase SatelliteContractVersionAttribute le permite actualizar un ensamblado principal sin tener que actualizar el ensamblado satélite o viceversa.Cuando se actualiza el ensamblado principal, cambia su número de versión de ensamblado.Si desea seguir utilizando los ensamblados satélite existentes, cambie el número de versión del ensamblado principal, pero deje intacto el número de versión del contrato satélite.Por ejemplo, en su primera versión, la versión de ensamblado principal podría ser 1.0.0.0.La versión de contrato satélite y la versión de ensamblado del ensamblado satélite también será 1.0.0.0.Si tiene que actualizar el ensamblado principal para un Service Pack, puede cambiar la versión de ensamblado a 1.0.0.1, a la vez que conserva la versión de contrato satélite y la versión de ensamblado del satélite como 1.0.0.0.
Si debe actualizar un ensamblado satélite pero no el ensamblado principal, cambie el AssemblyVersionAttribute del ensamblado satélite.Junto con el ensamblado satélite, tendrá que incluir una directiva de ensamblado que confirme que el nuevo ensamblado satélite es compatible con el antiguo ensamblado satélite.Para obtener más información sobre directivas, vea Cómo localiza ensamblados el motor de ejecución.
En el código siguiente se muestra cómo establecer la versión de contrato satélite.El código se puede incluir en un script de compilación o en el archivo AssemblyInfo.vb o AssemblyInfo.cs.
<Assembly: SatelliteContractVersionAttribute("4.3.2.1")>
[assembly: SatelliteContractVersionAttribute("4.3.2.1")]
Vea también
Conceptos
Cómo el motor en tiempo de ejecución ubica ensamblados
Configurar atributos de ensamblados
Seguridad y ensamblados satélite localizados