LocalFileSettingsProvider.Upgrade Méthode

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

LocalFileSettingsProvider.cs

Tentatives de migrer des paramètres de portée utilisateur antérieurs à partir d'une version antérieure de la même application.

public:
 virtual 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
override this.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.

Implémente

Upgrade(SettingsContext, SettingsPropertyCollection)

Exceptions

ConfigurationErrorsException

Un paramètre de portée utilisateur a été rencontré, mais la configuration actuelle prend en charge uniquement les paramètres de portée application.

- ou -

Impossible d'accéder à la version antérieure du fichier de configuration.

Remarques

LocalFileSettingsProvider migre les paramètres locaux et d’itinérance dans des opérations distinctes.

La Upgrade méthode est supprimée pour chaque paramètre d’application auquel le est NoSettingsVersionUpgradeAttribute appliqué, ou pour la classe wrapper de paramètres entière, dérivée de ApplicationSettingsBase.

De cette façon, cette méthode est appelée dépend du type d’application en cours de mise à niveau :

• Chaque version d’une application ClickOnce est stockée dans son propre répertoire d’installation isolé. Une fois qu’une nouvelle version d’une application ClickOnce est installée et que la nouvelle version est exécutée pour la première fois, la logique interne appelle Upgrade automatiquement pour migrer tous les paramètres d’application courants vers la nouvelle version. Pour plus d'informations, consultez ClickOnce et paramètres d’application.

• Les applications Windows Forms et console standard doivent appeler Upgrademanuellement , car il n’existe pas de méthode générale et automatique pour déterminer quand une telle application est exécutée pour la première fois. Les deux méthodes courantes pour ce faire sont soit à partir du programme d’installation, soit à partir de l’application elle-même, à l’aide d’une propriété persistante, souvent nommée quelque chose comme IsFirstRun.

Notez que pour que la version la plus récente migre les paramètres d’application, elle doit également être en mesure de charger et de lire l’ancienne version des paramètres de l’application. Par conséquent, il doit contenir des classes wrapper compatibles avec les versions nouvelle et précédente de l’application.

Voir aussi

• GetPreviousVersion(SettingsContext, SettingsProperty)
• Reset(SettingsContext)
• IApplicationSettingsProvider
• NoSettingsVersionUpgradeAttribute