LocalFileSettingsProvider.Upgrade Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Tentatives de migrer des paramètres de portée utilisateur antérieurs à partir d'une version antérieure de la même application.
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)Paramètres
- context
- SettingsContext
SettingsContext décrivant l'utilisation de l'application actuelle.
- properties
- SettingsPropertyCollection
SettingsPropertyCollection contenant le groupe de propriétés de paramètres dont les valeurs seront récupérées.
Implémente
Exceptions
Un paramètre de portée utilisateur a été rencontré, mais la configuration actuelle prend en charge uniquement les paramètres de portée application.
- ou -
Impossible d'accéder à la version antérieure du fichier de configuration.
Remarques
LocalFileSettingsProvider migre les paramètres locaux et d’itinérance dans des opérations distinctes.
La Upgrade méthode est supprimée pour chaque paramètre d’application auquel le est NoSettingsVersionUpgradeAttribute appliqué, ou pour la classe wrapper de paramètres entière, dérivée de ApplicationSettingsBase.
De cette façon, cette méthode est appelée dépend du type d’application en cours de mise à niveau :
Chaque version d’une application ClickOnce est stockée dans son propre répertoire d’installation isolé. Une fois qu’une nouvelle version d’une application ClickOnce est installée et que la nouvelle version est exécutée pour la première fois, la logique interne appelle Upgrade automatiquement pour migrer tous les paramètres d’application courants vers la nouvelle version. Pour plus d'informations, consultez ClickOnce et paramètres d’application.
Les applications Windows Forms et console standard doivent appeler Upgrademanuellement , car il n’existe pas de méthode générale et automatique pour déterminer quand une telle application est exécutée pour la première fois. Les deux méthodes courantes pour ce faire sont soit à partir du programme d’installation, soit à partir de l’application elle-même, à l’aide d’une propriété persistante, souvent nommée quelque chose comme
IsFirstRun.
Notez que pour que la version la plus récente migre les paramètres d’application, elle doit également être en mesure de charger et de lire l’ancienne version des paramètres de l’application. Par conséquent, il doit contenir des classes wrapper compatibles avec les versions nouvelle et précédente de l’application.
