Número de versión de los ensamblados principales y los ensamblados satélite localizadosVersion Numbers for Main and Localized Satellite Assemblies

La clase SatelliteContractVersionAttribute proporciona compatibilidad de versiones para un ensamblado principal que usa recursos localizados mediante el administrador de recursos.The SatelliteContractVersionAttribute class provides versioning support for a main assembly that uses localized resources by means of the resource manager. Aplicar SatelliteContractVersionAttribute al ensamblado principal de una aplicación le permite actualizar y volver a implementar el ensamblado sin actualizar sus ensamblados satélite.Applying the SatelliteContractVersionAttribute to an application's main assembly allows you to update and re-deploy the assembly without updating its satellite assemblies. Por ejemplo, puede usar la clase SatelliteContractVersionAttribute con un Service Pack que no introduce nuevos recursos sin volver a compilar e implementar los ensamblados satélite.For example, you can use the SatelliteContractVersionAttribute class with a service pack that doesn't introduce new resources without rebuilding and redeploying your satellite assemblies. Para que los recursos localizados estén disponibles, la versión de contrato satélite del ensamblado principal debe coincidir con la clase AssemblyVersionAttribute de los ensamblados satélite.For your localized resources to be available, the satellite contract version of your main assembly must match the AssemblyVersionAttribute class of your satellite assemblies. Debe especificar un número de versión exacto en SatelliteContractVersionAttribute; los caracteres comodín como "" no están permitidos.You must specify an exact version number in the SatelliteContractVersionAttribute; wildcard characters such as "" are not allowed. Para obtener más información, consulte Recuperar recursos.For more information, see Retrieving Resources.

Actualizar ensambladosUpdating Assemblies

La clase SatelliteContractVersionAttribute le permite actualizar un ensamblado principal sin tener que actualizar el ensamblado satélite, o viceversa.The SatelliteContractVersionAttribute class allows you to update a main assembly without having to update your satellite assembly, or vice versa. Cuando se actualiza el ensamblado principal, se cambia su número de versión de ensamblado.When the main assembly is updated, its assembly version number is changed. Si quiere seguir usando los ensamblados satélite existentes, cambie el número de versión del ensamblado principal pero deje igual el número de versión del contrato satélite.If you want to continue using the existing satellite assemblies, change the main assembly's version number but leave the satellite contract version number the same. Por ejemplo, la primera versión del ensamblado principal podría ser 1.0.0.0.For example, in your first release your main assembly version may be 1.0.0.0. La versión de contrato satélite y la versión del ensamblado satélite serán también 1.0.0.0.The satellite contract version and the assembly version of the satellite assembly will also be 1.0.0.0. Si necesita actualizar el ensamblado principal para un Service Pack, puede cambiar la versión de ensamblado a 1.0.0.1, manteniendo la versión de contrato satélite y la versión de ensamblado del satélite como 1.0.0.0.If you need to update your main assembly for a service pack, you can change the assembly version to 1.0.0.1, while keeping the satellite contract version and the satellite's assembly version as 1.0.0.0.

Si necesita actualizar un ensamblado satélite pero no el ensamblado principal, cambie el atributo AssemblyVersionAttribute del ensamblado satélite.If you need to update a satellite assembly but not your main assembly, you change the AssemblyVersionAttribute of the satellite assembly. Junto con el ensamblado satélite, tendrá que distribuir un ensamblado de directiva que indique que el nuevo ensamblado satélite es compatible con el ensamblado satélite antiguo.Along with your satellite assembly, you will have to ship a policy assembly that states that your new satellite assembly is compatible with your old satellite assembly. Para obtener más información sobre directivas, consulte Cómo el motor en tiempo de ejecución ubica ensamblados.For more information on policies, see How the Runtime Locates Assemblies.

El código siguiente muestra cómo establecer la versión de contrato satélite.The following code shows how to set the satellite contract version. El código se puede colocar en un script de compilación o en el archivo AssemblyInfo.vb o AssemblyInfo.cs.The code can be placed in either a build script or in the AssemblyInfo.vb or AssemblyInfo.cs file.

<Assembly: SatelliteContractVersionAttribute("4.3.2.1")>  
[assembly: SatelliteContractVersionAttribute("4.3.2.1")]  

Vea tambiénSee Also

Cómo el motor en tiempo de ejecución ubica ensamblados How the Runtime Locates Assemblies
Configurar atributos de ensamblados Setting Assembly Attributes
Seguridad y ensamblados satélite localizados Security and Localized Satellite Assemblies
Localizar aplicaciones Localizing Applications
Globalizar y localizar aplicacionesGlobalizing and Localizing Applications