IApplicationSettingsProvider.Upgrade Méthode

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

IApplicationSettingsProvider.cs

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 -> unit

Public 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.

Voir aussi

• GetPreviousVersion(SettingsContext, SettingsProperty)
• Upgrade()
• NoSettingsVersionUpgradeAttribute
• Exécution côte à côte