LocalFileSettingsProvider.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í.
Intenta migrar la anterior configuración de ámbito de usuario de una versión anterior de la misma aplicación.
public:
virtual 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 -> unit
override this.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.
Implementaciones
Excepciones
Se ha detectado una configuración con ámbito de usuario pero la configuración actual sólo admite valores de configuración con ámbito de aplicación.
o bien
No se ha podido obtener acceso a la versión anterior del archivo de configuración.
Comentarios
LocalFileSettingsProvider migra la configuración local y de itinerancia en operaciones independientes.
El Upgrade método se suprime para cada configuración de aplicación que tiene aplicado NoSettingsVersionUpgradeAttribute o a toda la clase contenedora de configuración, derivada de ApplicationSettingsBase.
De este modo, se llama a este método depende del tipo de aplicación que se está actualizando:
Cada versión de una aplicación ClickOnce se almacena en su propio directorio de instalación aislado. Una vez instalada una nueva versión de una aplicación ClickOnce y cuando se ejecute la nueva versión por primera vez, la lógica interna llamará Upgrade automáticamente para migrar todas las configuraciones comunes de la aplicación a la nueva versión. Para más información, consulte ClickOnce y configuración de la aplicación.
Las aplicaciones de consola y Windows Forms estándar deben llamar Upgrademanualmente a , ya que no hay una manera general y automática de determinar cuándo se ejecuta por primera vez dicha aplicación. Las dos formas comunes de hacerlo son desde el programa de instalación o mediante desde la propia aplicación, mediante una propiedad persistente, a menudo denominada algo como
IsFirstRun.
Tenga en cuenta que, para que la versión más reciente migre la configuración de la aplicación, también debe poder cargar y leer la versión anterior de la configuración de la aplicación. Por lo tanto, debe contener clases contenedoras compatibles con las versiones nuevas y anteriores de la aplicación.
