ApplicationSettingsBase.Upgrade Método

Definición

Espacio de nombres:

System.Configuration

Ensamblado:

System.Configuration.ConfigurationManager.dll

Paquete:

System.Configuration.ConfigurationManager v8.0.0

Source:

ApplicationSettingsBase.cs

Actualiza la configuración de la aplicación para reflejar una instalación más reciente de la aplicación.

public:
 virtual void Upgrade();

public virtual void Upgrade ();

abstract member Upgrade : unit -> unit
override this.Upgrade : unit -> unit

Public Overridable Sub Upgrade ()

Excepciones

ConfigurationErrorsException

No se pudo analizar el archivo de configuración.

Comentarios

El Upgrade método realiza dos acciones para garantizar una transición fluida a una nueva versión de una aplicación:

• Notifica a todos los proveedores de configuración correspondientes la existencia de la aplicación actualizada a través de una llamada a su IApplicationSettingsProvider.Upgrade método, suponiendo que han implementado la IApplicationSettingsProvider interfaz . Esta acción no se realiza si la clase contenedora de configuración está marcada con NoSettingsVersionUpgradeAttribute.

• Vuelve a cargar los valores de toda la configuración de la aplicación.

Puede invalidar el comportamiento predeterminado de Upgrade para implementar la actualización personalizada o el comportamiento de combinación. Use el GetPreviousVersion método para recuperar valores individuales para una configuración de la versión anterior de la aplicación. Entre los ejemplos de comportamiento de actualización personalizado se incluyen los siguientes:

• Con los valores predeterminados de directiva nuevos que invalidan uno o varios de los valores especificados por el usuario anteriores o los valores predeterminados anteriores.

• Traducción especial de valores antiguos para que sean compatibles con intervalos más recientes, un grupo de propiedades de configuración diferente, etc.

Consulte también

• Providers
• Reload()
• GetPreviousVersion(String)
• NoSettingsVersionUpgradeAttribute
• Upgrade(SettingsContext, SettingsPropertyCollection)