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.
Tente de migrer les paramètres d’étendue utilisateur précédents à partir d’une version précédente 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
Description SettingsContext de l’utilisation actuelle de l’application.
- properties
- SettingsPropertyCollection
Contenant SettingsPropertyCollection le groupe de propriétés des paramètres dont les valeurs doivent être récupérées.
Implémente
Exceptions
Un paramètre d’étendue utilisateur a été rencontré, mais la configuration actuelle prend uniquement en charge les paramètres d’étendue de l’application.
-ou-
Impossible d’accéder à la version précédente du fichier de configuration.
Remarques
LocalFileSettingsProvider migre les paramètres locaux et itinérants dans des opérations distinctes.
La Upgrade méthode est supprimée pour chaque paramètre d’application qui lui est appliqué, ou à la NoSettingsVersionUpgradeAttribute 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 standard Windows Forms et console doivent appeler manuellement Upgrade, car il n’existe pas un moyen général et automatique de déterminer quand une telle application est exécutée pour la première fois. Les deux méthodes courantes pour ce faire proviennent du programme d’installation ou de l’utilisation 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 nouvelles et précédentes de l’application.