IApplicationSettingsProvider.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.
Indique au fournisseur que l'application a été mise à niveau. Cela offre au fournisseur la possibilité de mettre à niveau ses paramètres stockés selon les besoins.
public:
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 -> 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.
Remarques
Le .NET Framework permet l’installation côte à côte et l’exécution de différentes versions de la même application. Le fournisseur de paramètres d’application stocke les paramètres d’application pour chaque version d’une application séparément pour garantir l’isolation. Toutefois, vous pouvez migrer les paramètres de la version précédente d’une application vers la version actuelle. Pour fournir cette fonctionnalité de migration, utilisez la Upgrade méthode, implémentée dans une classe dérivée de SettingsProvider.
Vous pouvez utiliser la Upgrade méthode conjointement avec la GetPreviousVersion méthode pour migrer les paramètres d’application pendant ou après l’installation d’une nouvelle version d’une application.
Cette méthode doit être supprimée pour chaque paramètre d’application auquel est appliqué le NoSettingsVersionUpgradeAttribute est appliqué, ou à la classe wrapper de paramètres entière, dérivée de ApplicationSettingsBase.
