Procedura: Gestire gli aggiornamenti per un'applicazione ClickOnceHow to: Manage updates for a ClickOnce application

ClickOnceClickOncele applicazioni possono verificare la disponibilità di aggiornamenti automaticamente o a livello di codice.applications can check for updates automatically or programmatically. Gli sviluppatori hanno molta flessibilità nell'specificare quando e come vengono eseguiti i controlli di aggiornamento, se gli aggiornamenti sono obbligatori e quando l'applicazione deve verificare la disponibilità di aggiornamenti.As a developer, you have lots of flexibility in specifying when and how update checks are performed, whether updates are mandatory, and where the application should check for updates.

È possibile configurare l'applicazione per verificare la disponibilità di aggiornamenti automaticamente prima che l'applicazione venga avviata o a intervalli prestabiliti dopo l'avvio dell'applicazione.You can configure the application to check for updates automatically before the application starts, or at set intervals after the application starts. È inoltre possibile specificare una versione minima richiesta. ovvero viene installato un aggiornamento se la versione dell'utente è inferiore alla versione richiesta.In addition you can specify a minimum required version; that is, an update is installed if the user's version is lower than the required version.

È possibile configurare l'applicazione per verificare la disponibilità di aggiornamenti a livello di codice in base a un evento, ad esempio una richiesta dell'utente.You can configure the application to check for updates programmatically based on an event such as a user request. La procedura "per verificare la disponibilità di aggiornamenti a livello di codice" in questo argomento illustra come scrivere codice che ApplicationDeployment usa la classe per verificare la disponibilità di aggiornamenti in base a un evento.The procedure "To check for updates programmatically" in this topic shows how you would write code that uses the ApplicationDeployment class to check for updates based on an event.

È anche possibile distribuire l'applicazione da un percorso e aggiornarlo da un altro.You can also deploy your application from one location and update it from another. Vedere la procedura "per specificare un percorso di aggiornamento diverso".See the procedure "To specify a different update location."

Per ulteriori informazioni, vedere scelta di una strategia di aggiornamento ClickOnce.For more information, see Choosing a ClickOnce Update Strategy.

Il comportamento di aggiornamento viene gestito nella finestra di dialogo Aggiornamenti applicazione , disponibile nella pagina pubblica di Progettazione progetti.Update behavior is managed in the Application Updates dialog box, available from the Publish page of the Project Designer.

Per verificare la disponibilità di aggiornamenti prima dell'avvio dell'applicazioneTo check for updates before the application starts

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.With a project selected in Solution Explorer, on the Project menu, click Properties.

  2. Fare clic sulla scheda Pubblica.Click the Publish tab.

  3. Fare clic sul pulsante aggiornamenti per aprire la finestra di dialogo Aggiornamenti applicazione .Click the Updates button to open the Application Updates dialog box.

  4. Nella finestra di dialogo Aggiornamenti applicazione assicurarsi che la casella di controllo l'applicazione deve verificare la disponibilità di aggiornamenti sia selezionata.In the Application Updates dialog box, make sure that the The application should check for updates check box is selected.

  5. Nella sezione scegliere quando controllare gli aggiornamenti dell'applicazione selezionare prima che l'applicazione venga avviata.In the Choose when the application should check for updates section, select Before the application starts. In questo modo si garantisce che gli utenti connessi alla rete eseguano sempre l'applicazione con gli aggiornamenti più recenti.This ensures that users connected to the network always run the application with the latest updates.

Per cercare gli aggiornamenti in background dopo l'avvio dell'applicazioneTo check for updates in the background after the application starts

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.With a project selected in Solution Explorer, on the Project menu, click Properties.

  2. Fare clic sulla scheda Pubblica.Click the Publish tab.

  3. Fare clic sul pulsante aggiornamenti per aprire la finestra di dialogo Aggiornamenti applicazione .Click the Updates button to open the Application Updates dialog box.

  4. Nella finestra di dialogo Aggiornamenti applicazione verificare che sia selezionata la casella di controllo l'applicazione deve verificare la disponibilità di aggiornamenti .In the Application Updates dialog box, make sure that the check box The application should check for updates is selected.

  5. Nella sezione scegliere quando controllare gli aggiornamenti dell'applicazioneselezionare dopo l'avvio dell'applicazione.In the Choose when the application should check for updates section, select After the application starts. L'applicazione verrà avviata più rapidamente in questo modo, quindi verificherà la disponibilità di aggiornamenti in background e invierà una notifica all'utente solo quando è disponibile un aggiornamento.The application will start more quickly this way, and then it will check for updates in the background, and only notify the user when an update is available. Una volta installato, gli aggiornamenti non saranno effettivi fino al riavvio dell'applicazione.Once installed, updates will not take effect until the application is restarted.

  6. Nella sezione specificare la frequenza con cui l'applicazione deve verificare la disponibilità di aggiornamenti selezionare Controlla ogni volta che viene eseguita l'applicazione (impostazione predefinita) o Controlla ogni e immettere un numero e un intervallo di tempo.In the Specify how frequently the application should check for updates section, select either Check every time the application runs (the default) or Check every and enter a number and time interval.

Per specificare una versione minima richiesta per l'applicazioneTo specify a minimum required version for the application

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.With a project selected in Solution Explorer, on the Project menu, click Properties.

  2. Fare clic sulla scheda Pubblica.Click the Publish tab.

  3. Fare clic sul pulsante aggiornamenti per aprire la finestra di dialogo Aggiornamenti applicazione .Click the Updates button to open the Application Updates dialog box.

  4. Nella finestra di dialogo Aggiornamenti applicazione assicurarsi che la casella di controllo l'applicazione deve verificare la disponibilità di aggiornamenti sia selezionata.In the Application Updates dialog box, make sure that the The application should check for updates check box is selected.

  5. Selezionare la casella di controllo specificare una versione minima richiesta per l'applicazione , quindi immettere i numeri principale, secondario, Builde Revisione per l'applicazione.Select the Specify a minimum required version for this application check box, and then enter Major, Minor, Build, and Revision numbers for the application.

Per specificare un percorso di aggiornamento diversoTo specify a different update location

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.With a project selected in Solution Explorer, on the Project menu, click Properties.

  2. Fare clic sulla scheda Pubblica.Click the Publish tab.

  3. Fare clic sul pulsante aggiornamenti per aprire la finestra di dialogo Aggiornamenti applicazione .Click the Updates button to open the Application Updates dialog box.

  4. Nella finestra di dialogo Aggiornamenti applicazione assicurarsi che la casella di controllo l'applicazione deve verificare la disponibilità di aggiornamenti sia selezionata.In the Application Updates dialog box, make sure that the The application should check for updates check box is selected.

  5. Nel campo percorso aggiornamento immettere il percorso di aggiornamento con un URL completo, usando il formato http://Hostname/ApplicationName o un percorso UNC usando il formato \ \Server\ApplicationNameoppure fare clic sul pulsante Sfoglia per cercare il percorso di aggiornamento.In the Update location field, enter the update location with a fully qualified URL, using the format http://Hostname/ApplicationName, or a UNC path using the format \\Server\ApplicationName, or click the Browse button to browse for the update location.

Per verificare la disponibilità di aggiornamenti a livello di codiceTo check for updates programmatically

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.With a project selected in Solution Explorer, on the Project menu, click Properties.

  2. Fare clic sulla scheda Pubblica.Click the Publish tab.

  3. Fare clic sul pulsante aggiornamenti per aprire la finestra di dialogo Aggiornamenti applicazione .Click the Updates button to open the Application Updates dialog box.

  4. Nella finestra di dialogo Aggiornamenti applicazione assicurarsi che la casella di controllo l'applicazione deve verificare la disponibilità di aggiornamenti sia deselezionata.In the Application Updates dialog box, make sure that the The application should check for updates check box is cleared. Facoltativamente, è possibile selezionare questa casella di controllo per verificare la disponibilità di aggiornamenti a livello di codice e consentire al runtime di ClickOnce di controllare automaticamente la disponibilità di aggiornamenti.(Optionally, you can select this check box to check for updates programmatically and also let the ClickOnce runtime check for updates automatically.)

  5. Nel campo percorso aggiornamento immettere il percorso di aggiornamento con un URL completo, usando il formato http://Hostname/ApplicationName o un percorso UNC usando il formato \ \Server\ApplicationNameoppure fare clic sul pulsante Sfoglia per cercare il percorso di aggiornamento.In the Update location field, enter the update location with a fully qualified URL, using the format http://Hostname/ApplicationName, or a UNC path using the format \\Server\ApplicationName, or click the Browse button to browse for the update location. Il percorso di aggiornamento è il punto in cui l'applicazione cercherà una versione aggiornata di se stessa.The update location is where the application will look for an updated version of itself.

  6. Consente di creare un pulsante, una voce di menu o un altro elemento dell'interfaccia utente in un Windows Form che gli utenti selezioneranno per verificare la disponibilità di aggiornamenti.Create a button, menu item, or other user interface item on a Windows Form that users will select to check for updates. Dal gestore eventi di tale elemento, chiamare un metodo per verificare e installare gli aggiornamenti.From that item's event handler, call a method to check for and install updates. È possibile trovare un esempio di Visual Basic e codice C# visivo per un metodo di questo tipo in procedura: Verificare la disponibilità di aggiornamenti dell'applicazione a livello di codicetramite l'API di distribuzione ClickOnce.You can find an example of Visual Basic and Visual C# code for such a method in How to: Check for application updates programmatically using the ClickOnce deployment API.

  7. Compilare l'applicazione.Build your application.

Vedere ancheSee also