Installare .NET in Windows

Questo articolo illustra quali versioni di .NET sono supportate in Windows, come installare .NET e la differenza tra SDK e runtime.

A differenza di .NET Framework, .NET non è legato alla versione di Windows. È possibile avere una sola versione di .NET Framework installata in Windows. Tuttavia, .NET è autonomo e può essere installato ovunque nel computer. Alcune app potrebbero includere la propria copia di .NET.

Per impostazione predefinita, .NET viene installato nella directory Programma file\dotnet del computer, a meno che il metodo di installazione non scelga una directory diversa.

.NET è costituito dal runtime e dall'SDK. Il runtime esegue le app .NET e l'SDK viene usato per creare app.

Scegliere il runtime corretto

Esistono tre runtime diversi per Windows, che abilitano l'esecuzione di tipi di app diversi. L'SDK include tutti e tre i runtime e un programma di installazione per un runtime potrebbe includere un runtime aggiuntivo. La tabella seguente descrive il runtime incluso in ogni specifico programma di installazione di .NET:

Per assicurarsi di poter eseguire tutte le app .NET in Windows, installare sia il runtime di ASP.NET Core che il runtime di .NET Desktop. Il runtime ASP.NET Core esegue app basate sul Web e il runtime desktop .NET esegue app desktop, ad esempio un'app Windows Presentation Foundation (WPF) o Windows Form.

Scegliere come installare .NET

Esistono diversi modi per installare .NET e alcuni prodotti potrebbero gestire la propria versione di .NET. Se si installa .NET tramite software che gestisce la propria versione di .NET, potrebbe non essere abilitato a livello di sistema. Assicurarsi di comprendere le implicazioni dell'installazione di .NET tramite altri software.

Se non si è certi del metodo da scegliere dopo aver esaminato gli elenchi nelle sezioni seguenti, probabilmente è preferibile usare il programma di installazione di .NET.

Sviluppatori

• Visual Studio

  Usare Visual Studio per installare .NET quando si vogliono sviluppare app .NET con Visual Studio. Visual Studio gestisce la propria copia di .NET. Questo metodo installa i modelli di SDK, runtime e Visual Studio.

• Visual Studio Code - C# Dev Kit

  Installare l'estensione C# Dev Kit per Visual Studio Code per sviluppare app .NET. L'estensione può usare un SDK già installato o installarlo automaticamente.

Utenti e sviluppatori

• Programma di installazione di .NET

  Installare .NET con un pacchetto di Windows Installer, un eseguibile avviato dall'utente. Questo metodo può installare l'SDK e il runtime. Le installazioni vengono eseguite a livello di sistema.

• Gestione pacchetti Windows (WinGet)

  Usare WinGet per installare .NET quando si vuole gestire .NET tramite la riga di comando. Questo metodo può installare l'SDK e il runtime. Le installazioni vengono eseguite a livello di sistema.

• PowerShell

  Uno script di PowerShell in grado di automatizzare l'installazione dell'SDK o del runtime. È possibile scegliere la versione di .NET da installare.

Versioni supportate

La tabella seguente è un elenco delle versioni .NET attualmente supportate e delle versioni di Windows in cui sono supportate. Queste versioni rimangono supportate fino a quando la versione di .NET raggiunge la fine del supporto o la versione di Windows raggiunge il fine del ciclo di vita.

Le date di fine servizio delle versioni di Windows 10 sono segmentate per edizione. Solo le edizioni Home, Pro, Pro Education e Pro per workstation vengono prese in considerazione nella tabella seguente. Controllare la scheda dei fatti del ciclo di vita di Windows per informazioni specifiche.

Windows 7/8.1/Server 2012

Non è più disponibile una versione di .NET supportata in Windows 7 e Windows 8.1. Le ultime versioni supportate erano .NET 6 e il supporto è terminato il 12 novembre 2024.

Windows Server 2012 è ancora supportato da qualsiasi versione di .NET ancora supportata.

Tutte e tre queste versioni di Windows richiedono l'installazione di altre dipendenze:

I requisiti precedenti sono necessari anche se viene visualizzato un errore correlato a una delle dll seguenti:

• api-ms-win-crt-runtime-l1-1-0.dll
• api-ms-win-cor-timezone-l1-1-0.dll
• hostfxr.dll

PC Windows basati su Arm

.NET è supportato nei PC Windows basati su Arm. Le sezioni seguenti descrivono gli aspetti da considerare durante l'installazione di .NET.

Differenze dell'SDK

Le versioni x86, x64 e ARM64 di .NET SDK esistono indipendentemente l'una dall'altra. Se viene rilasciata una nuova versione, ogni installazione dell'architettura deve essere aggiornata.

Differenze di percorso

In un PC Windows basato su Arm, tutte le versioni Arm64 di .NET vengono installate nella normale cartella C:\Program Files\dotnet\. Tuttavia, la versione x64 della SDK .NET viene installata nella cartellaC:\Program Files\dotnet\x64\.

Variabili di percorso

Le variabili di ambiente che aggiungono .NET al percorso di sistema, ad esempio la variabile PATH, potrebbero dover essere modificate se sono installate entrambe le versioni x64 e ARM64 di .NET SDK. Inoltre, alcuni strumenti si basano sulla variabile di ambiente DOTNET_ROOT, che dovrebbe essere aggiornata anch’essa per puntare alla cartella di installazione appropriata della SDK .NET.

Installare con Visual Studio

Visual Studio installa la propria copia di .NET separata da altre copie di .NET. Versioni diverse di Visual Studio supportano versioni diverse di .NET. L'ultima versione di Visual Studio supporta sempre l'ultima versione di .NET.

Il programma di installazione di Visual Studio installa e configura Visual Studio. Alcuni carichi di lavoro di Visual Studio includono .NET, ad esempio ASP.NET e sviluppo Web e Sviluppo di app multipiattaforma .NET. È possibile installare versioni specifiche di .NET tramite la scheda Singoli componenti.

La documentazione di Visual Studio fornisce istruzioni su come:

• Installare Visual Studio.
• Configurare i carichi di lavoro di Visual Studio.

Versioni di .NET e Visual Studio

Se si usa Visual Studio per sviluppare app .NET, la tabella seguente descrive la versione minima necessaria di Visual Studio in base alla versione della SDK .NET di destinazione.

Se Visual Studio è già installato, è possibile controllare la versione seguendo questa procedura.

1. Aprire Visual Studio.
2. Selezionare Guida> su Microsoft Visual Studio.
3. Leggere il numero di versione dalla finestra di dialogo Informazioni.

Per altre informazioni, vedere Controllo delle versioni di .NET SDK, MSBuild e Visual Studio.

Installare con Visual Studio Code

Visual Studio Code è un editor di codice sorgente potente e leggero che viene eseguito sul desktop. Visual Studio Code può utilizzare l'SDK già installato nel sistema. Inoltre, l'estensione C# Dev Kit installerà .NET se non è già installata.

Per istruzioni sull'installazione di .NET tramite Visual Studio Code, consultare la sezione Introduzione a C# in VS Code.

Programma di installazione di .NET

La pagina di download per .NET fornisce i file eseguibili di Windows Installer.

1. Aprire un Web browser e passare a https://dotnet.microsoft.com/download/dotnet.

2. Selezionare la versione di .NET da scaricare, ad esempio 9.0.

3. Trovare la casella relativa all'SDK o al runtime che contiene i collegamenti per il download di .NET.

4. Nella colonna Programmi di installazione individuare la riga Windows e selezionare il collegamento per l'architettura della CPU in uso. In caso di dubbi, selezionare x64 perché è la più comune.

   Il browser deve scaricare automaticamente il programma di installazione.

   Suggerimento

   L'immagine seguente mostra l'SDK, ma è anche possibile scaricare il runtime.

   

5. Aprire Esplora risorse e passare alla posizione in cui è stato scaricato il file, molto probabilmente la cartella Download.

6. Fare doppio clic sul file per installare .NET.

   Si aprirà la finestra di dialogo di Windows Installer.

   

7. Selezionare Installa e seguire le istruzioni per installare .NET.

Per informazioni su come usare l'interfaccia della riga di comando di .NET, vedere Panoramica dell'interfaccia della riga di comando di .NET.

Opzioni della riga di comando

Usare il parametro /? per visualizzare un elenco di opzioni.

Se si desidera installare .NET in modo invisibile all'utente, ad esempio in un ambiente di produzione o per supportare l'integrazione continua, utilizzare le opzioni seguenti:

• /install
  Installa .NET.

• /quiet
  Impedisce la visualizzazione di qualsiasi interfaccia utente e richiesta.

• /norestart
  Impedisce qualsiasi tentativo di riavvio.

dotnet-sdk-9.0.100-win-x64.exe /install /quiet /norestart

Installare con Gestione pacchetti Windows (WinGet)

È possibile installare e gestire .NET tramite il servizio Gestione pacchetti di Windows usando lo strumento winget.exe. Per altre informazioni su come installare e usare WinGet, vedere Usare lo strumento WinGet per installare e gestire applicazioni.

Se si installa .NET a livello di sistema, procedere all’installazione con privilegi amministrativi.

I pacchetti WinGet di .NET sono:

• Microsoft.DotNet.Runtime.9—.NET Runtime 9.0
• Microsoft.DotNet.AspNetCore.9—ASP.NET Core Runtime 9.0
• Microsoft.DotNet.DesktopRuntime.9—.NET Desktop Runtime 9.0
• Microsoft.DotNet.SDK.9—.NET SDK 9.0
• Microsoft.DotNet.Runtime.8—.NET Runtime 8.0
• Microsoft.DotNet.AspNetCore.8 - Runtime di ASP.NET Core 8.0
• Microsoft.DotNet.DesktopRuntime.8 - Runtime di .NET Desktop 8.0
• Microsoft.DotNet.SDK.8 Runtime di .NET SDK 8.0

Installazione dell'SDK

Se si installa l'SDK, non è necessario installare il runtime corrispondente.

1. Installare WinGet.

2. Aprire un terminale, ad esempio PowerShell o il prompt dei comandi.

3. Eseguire il comando winget install e passare il nome del pacchetto SDK:

   winget install Microsoft.DotNet.SDK.9
   

Per informazioni su come usare l'interfaccia della riga di comando di .NET, vedere Panoramica dell'interfaccia della riga di comando di .NET.

Installare il runtime

Esistono vari runtime che è possibile installare. Fare riferimento alla sezione Scegliere il runtime corretto per comprendere cosa è incluso in ogni runtime.

1. Installare WinGet.

2. Aprire un terminale, ad esempio PowerShell o il prompt dei comandi.

3. Eseguire il comando winget install e passare il nome del pacchetto SDK:

   winget install Microsoft.DotNet.DesktopRuntime.9
   winget install Microsoft.DotNet.AspNetCore.9
   

Per informazioni su come usare l'interfaccia della riga di comando di .NET, vedere Panoramica dell'interfaccia della riga di comando di .NET.

Cercare versioni

Usare il comando winget search per cercare versioni diverse del pacchetto da installare. Ad esempio, il comando seguente cerca tutti gli SDK .NET disponibili tramite WinGet:

winget search Microsoft.DotNet.SDK

I risultati della ricerca vengono visualizzati in una tabella con l'identificatore di ogni pacchetto.

Name                           Id                           Version                    Source
----------------------------------------------------------------------------------------------
Microsoft .NET SDK 9.0         Microsoft.DotNet.SDK.9       9.0.100                    winget
Microsoft .NET SDK 8.0         Microsoft.DotNet.SDK.8       8.0.300                    winget
Microsoft .NET SDK 7.0         Microsoft.DotNet.SDK.7       7.0.409                    winget
Microsoft .NET SDK 6.0         Microsoft.DotNet.SDK.6       6.0.422                    winget
Microsoft .NET SDK 5.0         Microsoft.DotNet.SDK.5       5.0.408                    winget
Microsoft .NET SDK 3.1         Microsoft.DotNet.SDK.3_1     3.1.426                    winget

Installare le versioni di anteprima

Se è disponibile una versione di anteprima, sostituire il numero di versione nell'ID con la parola Preview. L'esempio seguente installa la versione di anteprima di Runtime .NET Desktop:

winget install Microsoft.DotNet.DesktopRuntime.Preview

Installare con PowerShell

L'installazione di .NET tramite lo script di PowerShell dotnet-install è consigliata per l'integrazione continua e le installazioni non amministrative. Se si installa .NET per il normale uso nel sistema, usare il Programma di installazione di .NET o Gestione pacchetti di Windows .

Per impostazione predefinita, lo script installa la versione Long Term Support (LTS) più recente, ovvero .NET 8. È possibile scegliere una versione specifica specificando l'opzione -Channel. Includere l'opzione -Runtime per installare un runtime. In caso contrario, lo script installa l'SDK. Lo script è disponibile all'indirizzo https://dot.net/v1/dotnet-install.ps1 e il codice sorgente è ospitato in GitHub.

Per altre informazioni sullo script, vedere le informazioni di riferimento sullo script dotnet-install.

Installare il runtime

Il runtime di .NET viene installato fornendo l'opzione -Runtime.

1. Scaricare lo script di installazione da https://dot.net/v1/dotnet-install.ps1

2. Aprire PowerShell e passare alla cartella contenente lo script.

3. Eseguire i comandi seguenti per installare sia il runtime Desktop che il runtime di ASP.NET Core al fine di garantire la massima compatibilità:

   dotnet-install.ps1 -Runtime windowsdesktop
   dotnet-install.ps1 -Runtime aspnetcore
   

Per informazioni su come usare l'interfaccia della riga di comando di .NET, vedere Panoramica dell'interfaccia della riga di comando di .NET.

Installazione dell'SDK

Se si installa l'SDK, non è necessario installare i runtime .

1. Scaricare lo script di installazione da https://dot.net/v1/dotnet-install.ps1

2. Aprire PowerShell e passare alla cartella contenente lo script.

3. Eseguire il comando seguente per installare .NET SDK.

   dotnet-install.ps1
   

   Nota

   L'SDK si installa omettendo l'opzione -Runtime.

Per informazioni su come usare l'interfaccia della riga di comando di .NET, vedere Panoramica dell'interfaccia della riga di comando di .NET.

Convalida

Dopo aver scaricato un programma di installazione o la versione binaria, verificare che il file non sia stato modificato o danneggiato. È possibile verificare il checksum nel computer e quindi confrontarlo con ciò che è stato segnalato nel sito Web di download.

Quando si scarica il file da una pagina di download ufficiale, viene visualizzato il checksum per il file in una casella di testo. Selezionare il pulsante Copia per copiare il valore del checksum negli Appunti.

È possibile usare PowerShell o il prompt dei comandi per convalidare il checksum del file scaricato. Ad esempio, il comando seguente segnala il checksum del file dotnet-sdk-8.0.100-win-x64.exe:

> certutil -hashfile dotnet-sdk-8.0.100-win-x64.exe SHA512
SHA512 hash of dotnet-sdk-8.0.100-win-x64.exe:
248acec95b381e5302255310fb9396267fd74a4a2dc2c3a5989031969cb31f8270cbd14bda1bc0352ac90f8138bddad1a58e4af1e56cc4a1613b1cf2854b518e
CertUtil: -hashfile command completed successfully.

> (Get-FileHash .\dotnet-sdk-8.0.100-win-x64.exe -Algorithm SHA512).Hash
248acec95b381e5302255310fb9396267fd74a4a2dc2c3a5989031969cb31f8270cbd14bda1bc0352ac90f8138bddad1a58e4af1e56cc4a1613b1cf2854b518e

Confrontare il checksum con il valore fornito dal sito di download.

Usare PowerShell e un file di checksum per convalidare

Le note sulla versione .NET contengono un collegamento a un file di checksum che è possibile utilizzare per convalidare il file scaricato. I passaggi seguenti descrivono come scaricare il file di checksum e convalidare un file binario di installazione di .NET:

1. La pagina delle note sulla versione per .NET 8 su GitHub all'indirizzo https://github.com/dotnet/core/tree/main/release-notes/8.0 contiene una sezione denominata Releases. La tabella in questa sezione contiene collegamenti ai download e ai file di checksum per ogni versione di .NET 8:

   

2. Selezionare il collegamento per la versione di .NET scaricata. La sezione precedente usa SDK .NET 8.0.100, che si trova nella versione .NET 8.0.0.

   Suggerimento

   Se non si è certi della versione .NET che contiene il file di checksum, esplorare i collegamenti fino a rintracciarlo.

3. Nella pagina della versione è possibile visualizzare la versione di Runtime .NET e SDK .NET e un collegamento al file di checksum:

   

4. Copiare il collegamento al file di checksum.

5. Usare lo script seguente, ma sostituire il collegamento per scaricare il file di checksum appropriato:

   Invoke-WebRequest https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt -OutFile 8.0.0-sha.txt
   

6. Con il file checksum e il file di versione .NET scaricati nella stessa directory, cercare il file checksum per il checksum del download .NET:

   Al termine della convalida, viene visualizzata la stampa Vero:

   > (Get-Content .\8.0.0-sha.txt | Select-String "dotnet-sdk-8.0.100-win-x64.exe").Line -like (Get-FileHash .\dotnet-sdk-8.0.100-win-x64.exe -Algorithm SHA512).Hash + "*"
   True
   

   Se viene visualizzata la stampaFalso, il file scaricato non è valido e non deve essere utilizzato.

Risoluzione dei problemi

Dopo aver installato .NET SDK potrebbero verificarsi problemi durante il tentativo di eseguire comandi dell'interfaccia della riga di comando di .NET. In questa sezione vengono raccolte le problematiche comuni e vengono fornite le soluzioni.

• Non è stato trovata alcuna SDK .NET
• La compilazione di app è più lenta del previsto
• hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll mancante

Non è stato trovata alcuna SDK .NET

Molto probabilmente sono state installate sia le versioni x86 (a 32 bit) che x64 (a 64 bit) della SDK .NET. Ciò causa un conflitto perché, quando si esegue il comando dotnet, viene risolto nella versione x86 quando deve essere risolto nella versione x64. La soluzione al problema consiste nel modificare la variabile %PATH% per risolvere prima la versione x64.

1. Verificare che entrambe le versioni siano installate eseguendo il comando where.exe dotnet. In questo caso, verrà visualizzata una voce per le cartelle Program Files\ e Program Files (x86)\. Se la cartella Program Files (x86)\ appare per prima, come illustrato nell'esempio seguente, si tratta di una situazione non corretta ed è necessario continuare con il passaggio successivo.

   > where.exe dotnet
   C:\Program Files (x86)\dotnet\dotnet.exe
   C:\Program Files\dotnet\dotnet.exe
   

   Se la situazione è corretta e la cartella Program Files\ appare per prima, non si è verificato il problema di cui tratta questa sezione ed è necessario creare una richiesta di supporto per .NET in GitHub

2. Premere il pulsante Windows e digitare "Modifica le variabili di ambiente di sistema" nella ricerca. Selezionare Modifica le variabili di ambiente di sistema.

   

3. Viene visualizzata la finestra Proprietà di sistema nella scheda Avanzate. Selezionare Variabili di ambiente.

   

4. Nella finestra Variabili di ambiente, nel gruppo Variabili di sistema , selezionare la riga Percorso*, quindi selezionare il pulsante Modifica.

   

5. Usare i pulsanti Sposta su e Sposta giù per spostare la voceC:\Program Files\dotnet\ sopra C:\Program Files (x86)\dotnet\.

   

La compilazione di app è più lenta del previsto

Assicurarsi che Controllo app intelligente, una funzionalità di Windows, sia disattivata. L’attivazione di Controllo smart app è sconsigliata nei computer utilizzati per lo sviluppo. Qualsiasi impostazione diversa da disattivata" potrebbe influire negativamente sulle prestazioni dell'SDK.

hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll mancante

Installare Microsoft Visual C++ 2015-2019 Redistributable (64-bit o 32-bit).

Contenuto correlato

• Panoramica dell'interfaccia della riga di comando di .NET
• Eseguire l'aggiornamento a una nuova versione di .NET.
• Come verificare se .NET è già installato.
• Esercitazione: Esercitazione su Hello World.
• Tutorial: Creare una nuova app con Visual Studio Code.