IApplicationSettingsProvider.Upgrade Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Indica al proveedor que se ha actualizado la aplicación. De este modo el proveedor tiene una oportunidad de actualizar su configuración almacenada según resulte conveniente.
public:
void Upgrade(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyCollection ^ properties);public void Upgrade (System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyCollection properties);abstract member Upgrade : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyCollection -> unitPublic Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)Parámetros
- context
- SettingsContext
Objeto SettingsContext que describe el uso de la aplicación actual.
- properties
- SettingsPropertyCollection
Colección SettingsPropertyCollection que contiene el grupo de propiedades de configuración cuyos valores se van a recuperar.
Comentarios
.NET Framework permite la instalación y ejecución en paralelo de diferentes versiones de la misma aplicación. El proveedor de configuración de la aplicación almacena la configuración de la aplicación para cada versión de una aplicación por separado para garantizar el aislamiento. Sin embargo, es posible que desee migrar la configuración de la versión anterior de una aplicación a la actual. Para proporcionar esta funcionalidad de migración, use el Upgrade método , implementado en una clase derivada de SettingsProvider.
Puede usar el Upgrade método junto con el GetPreviousVersion método para migrar la configuración de la aplicación durante o después de la instalación de una nueva versión de una aplicación.
Este método debe suprimirse para cada configuración de aplicación que tenga aplicado NoSettingsVersionUpgradeAttribute o a toda la clase contenedora de configuración, derivada de ApplicationSettingsBase.
