Condividi tramite

Eseguire l'aggiornamento a una nuova versione di .NET

  • Articolo

Le nuove versioni di .NET vengono rilasciate ogni anno. Molti sviluppatori avviano il processo di aggiornamento non appena è disponibile la nuova versione, mentre altri attendono fino a quando la versione in uso non è più supportata. Per il processo di aggiornamento è necessario prendere in considerazione diversi aspetti.

Motivi comuni per eseguire l'aggiornamento a una nuova versione di .NET:

  • La versione di .NET attualmente usata non è più supportata
  • La versione nuova supporta un nuovo sistema operativo
  • La nuova versione include un'API, prestazioni o funzionalità di sicurezza importanti

Aggiornare l'ambiente di sviluppo

Per eseguire l'aggiornamento a una nuova versione di .NET, il componente principale da installare è .NET SDK. Include un'interfaccia della riga di comando di .NET aggiornata, un sistema di compilazione e una versione di runtime.

Il sito Web .NET offre programmi di installazione e archivi che è possibile scaricare e usare in qualsiasi sistema operativo e architettura supportati.

Alcuni sistemi operativi includono uno strumento di gestione pacchetti che è possibile usare anche per installare una nuova versione di .NET e si potrebbe preferire questa opzione.

Visual Studio installa automaticamente nuove versioni di .NET SDK. Per gli utenti di Visual Studio è sufficiente eseguire l'aggiornamento a una versione più recente di Visual Studio.

Aggiornare il codice sorgente

L'unica modifica necessaria per aggiornare un'app consiste nell'aggiornare la proprietà TargetFramework in un file di progetto alla versione più recente di .NET.

Ecco come eseguire questa operazione:

  • Aprire il file di progetto (il file *.csproj, *.vbproj o *.fsproj).
  • Modificare il valore della proprietà <TargetFramework> da net6.0 a net8.0, ad esempio.
  • Lo stesso criterio si applica alla proprietà <TargetFrameworks> se viene usata.

Upgrade Assistant può apportare automaticamente queste modifiche.

Il passaggio successivo consiste nel compilare il progetto (o la soluzione) con il nuovo SDK. Se sono necessarie modifiche aggiuntive, l'SDK visualizzerà avvisi ed errori in merito.

Potrebbe essere necessario eseguire dotnet workload restore per ripristinare i carichi di lavoro con la nuova versione dell'SDK.

Altre risorse:

Aggiornare l'integrazione continua (CI)

Le pipeline CI seguono un processo di aggiornamento simile a quello dei file di progetto e dei Dockerfile. In genere, è possibile aggiornare pipeline CI modificando solo i valori di versione.

Aggiornare l'ambiente di hosting

Esistono diversi criteri usati per l'hosting di applicazioni. Se l'ambiente di hosting include il runtime .NET, è necessario installare la nuova versione del runtime .NET. In Linux è necessario installare le dipendenze, che tuttavia in genere non cambiano tra le versioni di .NET.

Per i contenitori è necessario modificare le FROM istruzioni per includere nuovi numeri di versione.

L'esempio dockerfile seguente illustra il pull di un'immagine ASP.NET Core 9.0.

FROM mcr.microsoft.com/dotnet/aspnet:9.0

In un servizio cloud come Servizio app di Azure è necessaria una modifica della configurazione.