LocalFileSettingsProvider.Upgrade Método

Definición

Espacio de nombres:

System.Configuration

Ensamblado:

System.Configuration.ConfigurationManager.dll

Paquete:

System.Configuration.ConfigurationManager v8.0.0

Source:

LocalFileSettingsProvider.cs

Intenta migrar la anterior configuración de ámbito de usuario de una versión anterior de la misma aplicación.

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)

Parámetros

context

SettingsContext

Objeto SettingsContext que describe el uso de la aplicación actual.

properties

SettingsPropertyCollection

Colección SettingsPropertyCollection que contiene el grupo de propiedades de configuración cuyos valores se van a recuperar.

Implementaciones

Upgrade(SettingsContext, SettingsPropertyCollection)

Excepciones

ConfigurationErrorsException

Se ha detectado una configuración con ámbito de usuario pero la configuración actual sólo admite valores de configuración con ámbito de aplicación.

o bien

No se ha podido obtener acceso a la versión anterior del archivo de configuración.

Comentarios

LocalFileSettingsProvider migra la configuración local y de itinerancia en operaciones independientes.

El Upgrade método se suprime para cada configuración de aplicación que tiene aplicado NoSettingsVersionUpgradeAttribute o a toda la clase contenedora de configuración, derivada de ApplicationSettingsBase.

De este modo, se llama a este método depende del tipo de aplicación que se está actualizando:

• Cada versión de una aplicación ClickOnce se almacena en su propio directorio de instalación aislado. Una vez instalada una nueva versión de una aplicación ClickOnce y cuando se ejecute la nueva versión por primera vez, la lógica interna llamará Upgrade automáticamente para migrar todas las configuraciones comunes de la aplicación a la nueva versión. Para más información, consulte ClickOnce y configuración de la aplicación.

• Las aplicaciones de consola y Windows Forms estándar deben llamar Upgrademanualmente a , ya que no hay una manera general y automática de determinar cuándo se ejecuta por primera vez dicha aplicación. Las dos formas comunes de hacerlo son desde el programa de instalación o mediante desde la propia aplicación, mediante una propiedad persistente, a menudo denominada algo como IsFirstRun.

Tenga en cuenta que, para que la versión más reciente migre la configuración de la aplicación, también debe poder cargar y leer la versión anterior de la configuración de la aplicación. Por lo tanto, debe contener clases contenedoras compatibles con las versiones nuevas y anteriores de la aplicación.

Consulte también

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