LocalFileSettingsProvider.Upgrade Metodo

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

LocalFileSettingsProvider.cs

Tenta di eseguire la migrazione delle precedenti impostazioni con ambito di utente da una versione precedente della stessa applicazione.

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)

Parametri

context

SettingsContext

Oggetto SettingsContext che descrive l'utilizzo dell'applicazione corrente.

properties

SettingsPropertyCollection

Classe SettingsPropertyCollection contenente il gruppo di proprietà delle impostazioni di cui è necessario recuperare i valori.

Implementazioni

Upgrade(SettingsContext, SettingsPropertyCollection)

Eccezioni

ConfigurationErrorsException

È stata rilevata un'impostazione con ambito di utente, ma la configurazione corrente supporta solo le impostazioni con ambito di applicazione.

-oppure-

Non è possibile accedere alla versione precedente del file di configurazione.

Commenti

LocalFileSettingsProvider esegue la migrazione delle impostazioni locali e roaming nelle operazioni separate.

Il Upgrade metodo viene eliminato per ogni impostazione dell'applicazione applicata NoSettingsVersionUpgradeAttribute o all'intera classe wrapper delle impostazioni, derivata da ApplicationSettingsBase.

In questo modo questo metodo viene chiamato dipende dal tipo di applicazione che viene aggiornata:

• Ogni versione di un'applicazione ClickOnce viene archiviata nella propria directory di installazione isolata. Dopo l'installazione di una nuova versione di un'applicazione ClickOnce e quando viene eseguita la nuova versione, la logica interna chiamerà Upgrade automaticamente per eseguire la migrazione di tutte le impostazioni dell'applicazione comuni alla nuova versione. Per altre informazioni, vedere Impostazioni dell'applicazione e ClickOnce.

• Le applicazioni standard Windows Forms e console devono chiamare Upgrademanualmente , perché non esiste un modo generale e automatico per determinare quando tale applicazione viene eseguita per la prima volta. I due modi comuni per eseguire questa operazione sono dal programma di installazione o dall'applicazione stessa, usando una proprietà persistente, spesso denominata simile IsFirstRuna .

Si noti che per la versione più recente per eseguire la migrazione delle impostazioni dell'applicazione, deve essere in grado di caricare e leggere anche la versione precedente delle impostazioni dell'applicazione. Pertanto, deve contenere classi wrapper compatibili sia con le nuove che con le versioni precedenti dell'applicazione.

Vedi anche

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