Condividi tramite

Che cos'è .NET Upgrade Assistant?

.NET Upgrade Assistant consente di aggiornare i progetti a versioni più recenti di .NET e analizza il codice per individuare e correggere potenziali incompatibilità. Uno degli strumenti consiste nell'aggiornare un progetto da .NET Framework, .NET Core o .NET alla versione più recente di .NET. Usare l'estensione o lo strumento per aggiornare interi progetti .NET o alcuni aspetti del progetto, ad esempio l'aggiornamento di un file di configurazione da un tipo precedente a un tipo più recente.

.NET Upgrade Assistant viene distribuito come estensione di Visual Studio o come strumento dell'interfaccia della riga di comando .NET.

Importante

.NET Upgrade Assistant è ufficialmente deprecato. Usare invece l'agente di chat di modernizzazione dell'app GitHub Copilot , incluso in Visual Studio 2026 e Visual Studio 2022 17.14.16 o versione successiva. Questo agente analizza i progetti e le dipendenze, produce un piano di migrazione dettagliato con raccomandazioni mirate e correzioni automatiche del codice e esegue il commit di ogni modifica in modo da poter convalidare o eseguire il rollback. Automatizza le attività di conversione comuni, ad esempio l'aggiornamento dei file di progetto, la sostituzione delle API deprecate e la risoluzione dei problemi di compilazione, in modo da poter modernizzare più velocemente con un lavoro meno manuale.

Analizzare e aggiornare

.NET Upgrade Assistant include un motore di analisi che analizza i progetti e le relative dipendenze. Al termine dell'analisi, viene generato un report con informazioni dettagliate sull'esecuzione di un aggiornamento. È possibile usare queste informazioni per aggiornare l'intero progetto o parti specifiche del progetto.

Tipi di progetti non supportati

.NET Upgrade Assistant supporta l'aggiornamento di progetti codificati in C# o Visual Basic. Sono supportati i tipi di progetto seguenti:

  • ASP.NET
  • Funzioni di Azure
  • Windows Presentation Foundation
  • Windows Form
  • Librerie di classi
  • App console
  • Xamarin.Forms
  • .NET MAUI
  • UWP .NET Native

Alcuni prodotti forniscono indicazioni su come usare .NET Upgrade Assistant.

Percorsi di aggiornamento

Sono supportati i percorsi di aggiornamento seguenti:

  • Da .NET Framework a .NET
  • Da .NET Core a .NET
  • Funzioni di Azure isolato da v1-v3 a v4 (con destinazione net6.0+)
  • Da UWP a WinUI 3
  • Da una versione precedente di .NET alla versione più recente di .NET
  • Da Xamarin Forms a .NET MAUI
    • Le trasformazioni di file XAML supportano solo l'aggiornamento degli spazi dei nomi. Per trasformazioni più complete, usare Visual Studio 2022 o versione successiva.

Dettagli e opzioni di aggiornamento

Quando viene avviato un aggiornamento, una procedura guidata illustra la configurazione di alcune delle opzioni prima dell'avvio dell'aggiornamento. In base al tipo di progetto che si sta aggiornando, la procedura guidata presenta diverse opzioni. Per un esempio di aggiornamento di un progetto, vedere Aggiornare i progetti con .NET Upgrade Assistant.

Come deve essere eseguito l'aggiornamento

In base al tipo di progetto che si sta aggiornando, potrebbe essere possibile modificare la modalità di esecuzione dell'aggiornamento. Il tipo di progetto influisce sulle opzioni disponibili e uno o più degli elementi seguenti potrebbero non essere presenti:

  • Aggiornamento del progetto sul posto

    Questa opzione aggiorna il progetto senza creare una copia.

  • Aggiornamento del progetto side-by-side

    Copia il progetto e aggiorna la copia, lasciando intatto il progetto originale.

  • Aggiornamento incrementale side-by-side

    Questa è una buona scelta per app Web complesse. L'aggiornamento da ASP.NET a ASP.NET Core richiede un bel po' di lavoro e a volte il refactoring manuale. Questa modalità inserisce un progetto .NET accanto al progetto .NET Framework esistente. Gli endpoint vengono instradati attraverso il progetto .NET, mentre tutte le altre chiamate vengono inviate all'applicazione .NET Framework.

    Questa modalità consente di aggiornare lentamente l'app ASP.NET o libreria a fasi.

Risultati dell'aggiornamento

Al termine dell'aggiornamento, viene visualizzata una schermata di stato che mostra tutti gli artefatti associati all'aggiornamento. Ogni artefatto dell'aggiornamento può essere espanso per leggere altre informazioni sullo stato. Nell'elenco seguente vengono descritte le icone di stato:

  • Segno di spunta verde vuoto: lo strumento non ha trovato nulla dell'artefatto da aggiornare.
  • Segno di spunta verde pieno: l'artefatto è stato aggiornato e completato correttamente.
  • Simbolo di avviso giallo: l'artefatto è stato aggiornato, ma è necessario prendere in considerazione informazioni importanti.
  • Rosso X: l'aggiornamento dell'artefatto non è riuscito.

Scheda Risultati aggiornamento di .NET Upgrade Assistant in Visual Studio.

Inoltre, le azioni eseguite durante l'aggiornamento vengono registrate nella finestra Output sotto l'origine Assistente aggiornamento, come illustrato nell'immagine seguente:

Finestra di output in Visual Studio che mostra i risultati dell'Assistente aggiornamento .NET.

Dopo aver aggiornato il progetto, testarlo accuratamente.

Contenuto correlato

  • Last updated on