ApplicationSettingsBase.Upgrade Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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.