IApplicationSettingsProvider.Upgrade(SettingsContext, SettingsPropertyCollection) Méthode

Définition

Indique au fournisseur que l'application a été mise à niveau.Indicates to the provider that the application has been upgraded. Cela offre au fournisseur la possibilité de mettre à niveau ses paramètres stockés selon les besoins.This offers the provider an opportunity to upgrade its stored settings as appropriate.

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 -> unit
Public Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)

Paramètres

context
SettingsContext

SettingsContext décrivant l'utilisation de l'application actuelle.A SettingsContext describing the current application usage.

properties
SettingsPropertyCollection

SettingsPropertyCollection contenant le groupe de propriétés de paramètres dont les valeurs seront récupérées.A SettingsPropertyCollection containing the settings property group whose values are to be retrieved.

Remarques

Le .NET Framework permet l’installation et l’exécution côte à côte de différentes versions de la même application.The .NET Framework enables side-by-side installation and execution of different versions of the same 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.The application settings provider stores the application settings for each version of an application separately to ensure isolation. Toutefois, vous souhaiterez peut-être migrer les paramètres de la version précédente d’une application vers la version actuelle.However, you may want to migrate settings from the previous version of an application to the current one. Pour fournir cette fonctionnalité de migration, utilisez la Upgrade méthode, implémentée dans une classe dérivée de SettingsProvider .To provide this migration functionality, use the Upgrade method, implemented in a class derived from SettingsProvider.

Vous pouvez utiliser la Upgrade méthode conjointement avec la GetPreviousVersion méthode pour migrer des paramètres d’application pendant ou après l’installation d’une nouvelle version d’une application.You can use the Upgrade method in conjunction with the GetPreviousVersion method to migrate application settings during or after the installation of a new version of an application.

Cette méthode doit être supprimée pour chaque paramètre d’application auquel NoSettingsVersionUpgradeAttribute est appliqué, ou à la classe wrapper de paramètres entière, dérivée de ApplicationSettingsBase .This method should be suppressed for every application setting that has the NoSettingsVersionUpgradeAttribute is applied to it, or to the entire settings wrapper class, derived from ApplicationSettingsBase.

S’applique à

Voir aussi