ApplicationSettingsBase.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.
Met à jour les paramètres de l’application pour refléter une installation plus récente de l’application.
public:
virtual void Upgrade();
public virtual void Upgrade();
abstract member Upgrade : unit -> unit
override this.Upgrade : unit -> unit
Public Overridable Sub Upgrade ()
Exceptions
Impossible d’analyser le fichier de configuration.
Remarques
La Upgrade méthode effectue deux actions pour garantir une transition fluide vers une nouvelle version d’une application :
Il informe tous les fournisseurs de paramètres correspondants de l’existence de l’application mise à niveau par le biais d’un appel à leur IApplicationSettingsProvider.Upgrade méthode, en supposant qu’ils ont implémenté l’interface IApplicationSettingsProvider . Cette action n’est pas effectuée si la classe wrapper de paramètres est marquée avec NoSettingsVersionUpgradeAttribute.
Il recharge les valeurs de tous les paramètres de l’application.
Vous pouvez remplacer le comportement par défaut de l’implémentation d’une mise à niveau personnalisée ou d’un Upgrade comportement de fusion. Utilisez la GetPreviousVersion méthode pour récupérer des valeurs individuelles pour un paramètre pour la version précédente de l’application. Voici quelques exemples de comportement de mise à niveau personnalisé :
À l’aide de nouvelles valeurs par défaut de stratégie qui remplacent une ou plusieurs des valeurs spécifiées par l’utilisateur précédente ou les valeurs par défaut précédentes.
Traduction spéciale des anciennes valeurs à compatibilité avec les plages plus récentes, un groupe de propriétés de paramètres différent, et ainsi de suite.