Upgrade Method
Collapse the table of content
Expand the table of content

ApplicationSettingsBase.Upgrade Method ()

 

Updates application settings to reflect a more recent installation of the application.

Namespace:   System.Configuration
Assembly:  System (in System.dll)

public virtual void Upgrade()

Exception Condition
ConfigurationErrorsException

The configuration file could not be parsed.

The Upgrade method performs two actions to assure smooth transition to a new version of an application:

You can override the default behavior of Upgrade to implement custom upgrading or merging behavior. Use the GetPreviousVersion method to retrieve individual values for a setting for the previous version of the application. Examples of custom upgrade behavior include:

  • Using new policy defaults that override one or more of the previous user-specified values or previous defaults.

  • Special translation of old values to be compatible with newer ranges, a different settings property group, and so on.

.NET Framework
Available since 2.0
Return to top
Show:
© 2016 Microsoft