Impostazioni dell'applicazione e ClickOnce
Aggiornamento: novembre 2007
Impostazioni applicazione di Windows Form semplifica le operazioni di creazione, archiviazione e gestione delle preferenze personalizzate a livello di applicazione e utente nel computer client. Di seguito verrà descritto il funzionamento dei file di impostazioni in un'applicazione ClickOnce e verrà illustrata la modalità di migrazione delle impostazioni ClickOnce quando l'utente effettua l'aggiornamento alla versione successiva.
Le informazioni riportate di seguito sono applicabili solo al provider di impostazioni dell'applicazione predefinito, vale a dire la classe LocalFileSettingsProvider. Se si specifica un provider personalizzato, sarà quest'ultimo a determinare la modalità di archiviazione dei dati e di aggiornamento delle impostazioni tra una versione e un'altra. Per ulteriori informazioni sui provider di impostazioni dell'applicazione, vedere Architettura Impostazioni applicazione.
File di impostazioni dell'applicazione
Per le impostazioni dell'applicazione vengono utilizzati due file: app.exe.config e user.config, dove app è il nome dell'applicazione Windows Form. Il file user.config viene creato nel client la prima volta in cui l'applicazione archivia impostazioni con ambito di utente. Il file app.exe.config invece viene creato prima della distribuzione se si definiscono valori predefiniti per le impostazioni. In Visual Studio il file viene incluso automaticamente quando si utilizza il comando Pubblica. Se si crea un'applicazione ClickOnce utilizzando Mage.exe o MageUI.exe, è necessario accertarsi che il file venga incluso con gli altri file dell'applicazione quando si inseriscono i dati nel manifesto dell'applicazione.
In un'applicazione Windows Form che non viene distribuita mediante ClickOnce, il file app.exe.config viene archiviato nella directory dell'applicazione, mentre il file user.config viene archiviato nella cartella Documents and Settings dell'utente. In un'applicazione ClickOnce il file app.exe.config si trova nella directory dell'applicazione all'interno della cache di ClickOnce, mentre il file user.config si trova nella directory dati ClickOnce dell'applicazione.
A prescindere dalla modalità di distribuzione dell'applicazione, le impostazioni dell'applicazione garantiscono un accesso protetto in sola lettura al file app.exe.config e un accesso protetto in lettura/scrittura al file user.config.
In un'applicazione ClickOnce la dimensione dei file di configurazione utilizzata dalle impostazioni dell'applicazione è vincolata a quella della cache ClickOnce. Per ulteriori informazioni, vedere Cenni preliminari sulla cache di ClickOnce.
Aggiornamenti di versioni
Proprio come ogni versione di un'applicazione ClickOnce, che è isolata da tutte le altre versioni, le impostazioni relative a un'applicazione ClickOnce sono isolate da quelle relative alle altre versioni. Quando l'utente effettua l'aggiornamento a una versione più recente, le impostazioni della versione più recente (con il numero più alto) vengono confrontate con quelle fornite con la versione aggiornata e quindi unite in un nuovo insieme di file di impostazioni.
Nella tabella seguente sono illustrati i criteri in base ai quali vengono stabilite le impostazioni da copiare.
Tipo di modifica |
Azione di aggiornamento |
|---|---|
Impostazione aggiunta a app.exe.config |
La nuova impostazione viene unita al file app.exe.config della versione corrente |
Impostazione rimossa da app.exe.config |
L'impostazione obsoleta viene rimossa dal file app.exe.config della versione corrente |
Valore predefinito dell'impostazione modificato; in user.config è ancora specificato il valore predefinito originale per l'impostazione locale |
L'impostazione viene unita al file user.config della versione corrente con il nuovo valore predefinito |
Valore predefinito dell'impostazione modificato; in user.config è specificato un valore non predefinito per l'impostazione |
L'impostazione viene unita al file user.config della versione corrente e viene mantenuto il valore non predefinito |
Se è stata creata una classe wrapper personalizzata di impostazioni dell'applicazione per personalizzare la logica di aggiornamento, è possibile eseguire l'override del metodo Upgrade.
ClickOnce e impostazioni dei profili comuni
ClickOnce non interagisce con le impostazioni dei profili comuni, consentendo di utilizzare il file di impostazioni sui diversi computer di una rete. Se sono necessarie impostazioni dei profili comuni, implementare un provider di impostazioni dell'applicazione per l'archiviazione delle impostazioni sulla rete oppure sviluppare classi di impostazioni personalizzate per l'archiviazione delle impostazioni su un computer remoto. Per ulteriori informazioni sui provider di impostazioni, vedere Architettura Impostazioni applicazione.
Vedere anche
Concetti
Cenni preliminari sulla distribuzione ClickOnce
Cenni preliminari sulle impostazioni delle applicazioni