Come aggiornare i progetti alla versione attuale degli strumenti di Microsoft Azure per Visual Studio

Nota

Questo articolo si applica ad Azure Servizi cloud (versione classica), ora deprecata per i nuovi clienti e verrà ritirata il 31 agosto 2024. I servizi esistenti creati con questa tecnologia sono ancora supportati tramite Azure Servizi cloud (supporto esteso). Per un nuovo sviluppo, è consigliabile usare un tipo di servizio più recente progettato per scopi specifici, ad esempio servizio app Azure, Funzioni di Azure o app contenitore di Azure. Per l'elenco più recente dei servizi disponibili, vedere Directory dei prodotti Azure.

Dopo aver installato la versione corrente degli strumenti di Azure (o una versione precedente successiva alla 1.6), tutti i progetti creati usando una versione di Strumenti di Azure prima della versione 1.6 (novembre 2011) verranno aggiornati automaticamente non appena vengono aperti. Se sono stati creati progetti con la versione 1.6 (novembre 2011) di questi strumenti e la versione è ancora installata, è possibile aprire i progetti nella versione precedente e decidere in seguito se aggiornarli.

Modifiche apportate al progetto durante l'aggiornamento

Se un progetto viene aggiornato automaticamente o si specifica di volerlo aggiornare, verrà modificato in modo da funzionare con le versioni correnti di determinati assembly e verranno anche modificate alcune proprietà, come descritto in questa sezione. Se il progetto richiede altre modifiche per la compatibilità con la versione più recente degli strumenti, è necessario apportarle manualmente.

  • Il file web.config per i ruoli Web e il file app.config per i ruoli di lavoro vengono aggiornati in modo da fare riferimento alla versione più recente di Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener.dll.
  • Gli assembly Microsoft.WindowsAzure.StorageClient.dll, Microsoft.WindowsAzure.Diagnostics.dll e Microsoft.WindowsAzure.ServiceRuntime.dll vengono aggiornati alle nuove versioni.
  • I profili di pubblicazione archiviati nel file di progetto Azure (con estensione ccproj) vengono spostati in un file separato con estensione azurePubxml nella sottodirectory Publish .
  • Alcune proprietà del profilo di pubblicazione vengono aggiornate per supportare funzionalità nuove e modificate. AllowUpgrade viene sostituito da DeploymentReplacementMethod perché è possibile aggiornare un servizio cloud distribuito in modo simultaneo o incrementale.
  • La proprietà UseII edizione Standard xpressByDefault viene aggiunta e impostata su false in modo che il server Web utilizzato per il debug non cambierà automaticamente da Internet Information Services (IIS) a IIS Express. IIS Express è il server Web predefinito dei progetti creati con le versioni più recenti degli strumenti.
  • Se la memorizzazione nella cache di Azure è ospitata in uno o più ruoli del progetto, alcune proprietà nella configurazione del servizio (file con estensione cscfg) e nella definizione del servizio (file con estensione csdef) vengono modificate quando un progetto viene aggiornato. Se il progetto usa il pacchetto NuGet di Azure Caching, verrà aggiornato alla versione più recente del pacchetto. È necessario aprire il file web.config e verificare che la configurazione client sia stata gestita correttamente durante il processo di aggiornamento. Se si aggiungono riferimenti agli assembly del client Azure Caching senza usare il pacchetto NuGet, questi assembly non verranno aggiornati. È necessario aggiornare manualmente i riferimenti alle nuove versioni.

Importante

Per i progetti in F#, è necessario aggiornare manualmente i riferimenti agli assembly di Azure in modo che facciano riferimento alle versioni più recenti.

Come aggiornare un progetto Azure alla versione corrente

  1. Installare la versione corrente degli strumenti di Azure nell'installazione di Visual Studio da usare per il progetto aggiornato, quindi aprire il progetto da aggiornare. Se il progetto è stato creato con una versione di Strumenti di Azure prima della versione 1.6 (novembre 2011), il progetto viene aggiornato automaticamente alla versione corrente. Se il progetto è stato creato con la versione di novembre 2011 e tale versione è ancora installata, verrà aperto in quest'ultima.

  2. In Esplora soluzioni aprire il menu di scelta rapida per il nodo del progetto, scegliere Proprietà e quindi la scheda Applicazione della finestra di dialogo visualizzata.

    La scheda Applicazione mostra la versione degli strumenti associata al progetto. Se viene visualizzata la versione corrente degli strumenti di Azure, il progetto è già stato aggiornato. Se è stata installata una versione più recente degli strumenti rispetto a quella indicata nella scheda, viene visualizzato il pulsante Aggiorna .

  3. Scegliere il pulsante Aggiorna per aggiornare un progetto alla versione corrente degli strumenti.

  4. Creare il progetto, quindi trovare eventuali errori risultanti dalle modifiche API. Per informazioni su come modificare il codice per la nuova versione, vedere la documentazione per l'API specifica.