ApplicationSettingsBase.Upgrade Méthode

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

ApplicationSettingsBase.cs

Met à jour des paramètres d'application de façon à 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

ConfigurationErrorsException

Le fichier de configuration n'a pas pu être analysé.

Remarques

La Upgrade méthode effectue deux actions pour assurer une transition fluide vers une nouvelle version d’une application :

• Il avertit 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 pour tous les paramètres de l’application.

Vous pouvez remplacer le comportement par défaut de pour implémenter un comportement de mise à niveau ou de Upgrade fusion personnalisé. 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ée :

• Utilisation de nouvelles stratégies par défaut qui remplacent une ou plusieurs des valeurs précédentes spécifiées par l’utilisateur ou des valeurs par défaut précédentes.

• Traduction spéciale des anciennes valeurs pour être compatibles avec les plages plus récentes, un groupe de propriétés de paramètres différent, etc.

Voir aussi

• Providers
• Reload()
• GetPreviousVersion(String)
• NoSettingsVersionUpgradeAttribute
• Upgrade(SettingsContext, SettingsPropertyCollection)