Installare .NET in Windows

Questo articolo descrive come installare .NET in Windows. .NET è costituito dal runtime e dall'SDK. Il runtime viene usato per eseguire un'app .NET e può o meno essere incluso nell'app. L'SDK viene usato per creare app e librerie .NET. Il runtime .NET viene sempre installato con l'SDK.

La versione più recente di .NET è 5.0.

Versioni supportate

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

Windows 10 le date di fine servizio vengono segmentate in base all'edizione. Nella tabella seguente vengono considerate solo le edizioni Home , Pro, Pro Education e Pro per workstation. Per informazioni dettagliate Windows informazioni dettagliate, vedere l'elenco delle informazioni sul ciclo di vita del ciclo di vita.

Suggerimento

Un + simbolo rappresenta la versione minima.

Sistema operativo .NET Core 2.1 .NET Core 3.1 .NET 5
Windows 10/Windows Server, versione 20H2 ✔️ ✔️ ✔️
Windows 10/Windows Server, versione 2004 ✔️ ✔️ ✔️
Windows 10/Windows Server, versione 1909 ✔️ ✔️ ✔️
Windows 10/Windows Server, versione 1903 ✔️ ✔️ ✔️
Windows 10, versione 1809 ✔️ ✔️ ✔️
Windows 10, versione 1803 ✔️ ✔️ ✔️
Windows 10, versione 1709 ✔️ ✔️ ✔️
Windows 10, versione 1607 ✔️ ✔️ ✔️
Windows 8.1 ✔️ ✔️ ✔️
Windows 7 SP1 ESU ✔️ ✔️ ✔️
Windows Server 2019
Windows Server 2016
Windows Server 2012 R2
Windows Server 2012
✔️ ✔️ ✔️
Windows Server Core 2012 R2 ✔️ ✔️ ✔️
Windows Server Core 2012 ✔️ ✔️ ✔️
Nano Server, versione 1809+ ✔️ ✔️ ✔️
Nano Server, versione 1803 ✔️ ✔️

Versioni non supportate

Le versioni seguenti di .NET ❌ non sono più supportate:

  • 3.0
  • 2.2
  • 2,0

Informazioni di runtime

Il runtime viene usato per eseguire le app create con .NET. Quando un autore di app pubblica un'app, può includere il runtime con la propria app. Se non includono il runtime, l'utente deve installare il runtime.

Sono disponibili tre runtime diversi che è possibile installare in Windows:

  • ASP.NET Core runtime
    Esegue ASP.NET Core app. Include il runtime .NET.

  • Runtime desktop
    Esegue le app desktop .NET WPF e Windows Forms per Windows. Include il runtime .NET.

  • Runtime .NET
    Questo runtime è il runtime più semplice e non include altri runtime. È consigliabile installare sia il runtime ASP.NET Core desktop che il runtime desktop per garantire la migliore compatibilità con le app .NET.

Informazioni sull'SDK

L'SDK viene usato per compilare e pubblicare app e librerie .NET. L'installazione dell'SDK include tutti e tre i runtime:ASP.NET Core, Desktop e .NET.

Dipendenze

Le versioni Windows seguenti sono supportate con .NET 5.0:

Nota

Un + simbolo rappresenta la versione minima.

OS Versione Architetture
Client Windows 10 Versione 1607+ x64, x86, ARM64
Client Windows 7 SP1+, 8.1 x64, x86
Windows Server 2012+ x64, x86
Componenti di base di Windows Server 2012+ x64, x86
Nano Server Versione 1809+ x64

Per altre informazioni su sistemi operativi, distribuzioni e criteri del ciclo di vita supportati da .NET 5.0, vedere Versioni del sistema operativo supportate di .NET 5.0.

Windows 7 / Vista / 8.1 / Server 2008 R2 / Server 2012 R2

Sono necessarie altre dipendenze se si installa .NET SDK o il runtime nelle versioni Windows seguenti:

Sistema operativo Prerequisiti
Windows 7 SP1 ESU - Microsoft Visual C++ 2015-2019 Redistributable a / 32 bit a 64 bit
- KB3063858 a 64 bit / a 32 bit
- Microsoft Root Certificate Authority 2011 (solo programma di installazione offline di .NET Core 2.1)
Windows Vista SP 2 Microsoft Visual C++ 2015-2019 Redistributable a 32 bita / 64 bit
Windows 8.1 Microsoft Visual C++ 2015-2019 Redistributable a 32 bita / 64 bit
Windows Server 2008 R2 Microsoft Visual C++ 2015-2019 Redistributable a 32 bita / 64 bit
Windows Server 2012 Microsoft Visual C++ 2015-2019 Redistributable a 32 bita / 64 bit
Windows Server 2012 R2 Microsoft Visual C++ 2015-2019 Redistributable a 32 bita / 64 bit

I requisiti precedenti sono necessari anche se si riceve 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

Eseguire l'installazione con l'automazione di PowerShell

Gli script dotnet-install vengono usati per l'automazione ci e le installazioni non di amministrazione del runtime. È possibile scaricare lo script dalla pagina di riferimento dello script dotnet-install.

Per impostazione predefinita, lo script installa la versione LTS (Long Term Support) più recente, ovvero .NET Core 3.1. È possibile scegliere una versione specifica specificando Channel l'opzione . Includere Runtime l'opzione per installare un runtime. In caso contrario, lo script installa l'SDK.

dotnet-install.ps1 -Channel 5.0 -Runtime aspnetcore

Installare l'SDK omettendo -Runtime l'opzione . -ChannelL'opzione è impostata in questo esempio su Current , che installa la versione supportata più recente.

dotnet-install.ps1 -Channel Current

Eseguire l'installazione con Visual Studio

Se si usa Visual Studio per sviluppare app .NET, la tabella seguente descrive la versione minima richiesta di Visual Studio basata sulla versione di .NET SDK di destinazione.

Versione di .NET SDK Versione di Visual Studio
5.0 Visual Studio 2019 versione 16.8 o successiva.
3.1 Visual Studio 2019 versione 16.4 o successiva.
3.0 Visual Studio 2019 versione 16.3 o successiva.
2.2 Visual Studio 2017 versione 15.9 o successiva.
2.1 Visual Studio 2017 versione 15.7 o successiva.

Se è già stato Visual Studio, è possibile controllare la versione con la procedura seguente.

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

Visual Studio possibile installare la versione più recente di .NET SDK e il runtime.

Selezionare un carico di lavoro

Quando si installano o Visual Studio, selezionare uno o più dei carichi di lavoro seguenti, a seconda del tipo di applicazione che si sta compilando:

  • Carico di lavoro Sviluppo multipiattaforma .NET Core nella sezione Altri set di strumenti.
  • Carico ASP.NET e sviluppo Web nella sezione Web & Cloud.
  • Carico di lavoro Sviluppo di Azure nella sezione Web & Cloud.
  • Carico di lavoro Sviluppo di applicazioni desktop .NET nella sezione Desktop & Mobile.

Windows Visual Studio 2019 con carico di lavoro .NET Core

Installare insieme Visual Studio Code

Visual Studio Code è un editor di codice sorgente potente e leggero che viene eseguito sul desktop. Visual Studio Code è disponibile per Windows, macOS e Linux.

Anche Visual Studio Code non è disponibile un programma di installazione automatizzato di .NET Core come Visual Studio, l'aggiunta del supporto di .NET Core è semplice.

  1. Scaricare e installare Visual Studio Code.
  2. Scaricare e installare il .NET Core SDK.
  3. Installare l'estensione C# da Visual Studio Code Marketplace.

Windows Installer

Nella pagina di download per .NET sono disponibili Windows eseguibili del programma di installazione.

Quando si usano i Windows per installare .NET, è possibile personalizzare il percorso di installazione impostando i DOTNETHOME_X64 parametri DOTNETHOME_X86 e :

dotnet-sdk-3.1.301-win-x64.exe DOTNETHOME_X64="F:\dotnet\x64" DOTNETHOME_X86="F:\dotnet\x86"

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

  • /install
    Installa .NET.

  • /quiet
    Impedisce la visualizzazione dell'interfaccia utente e dei prompt.

  • norestart
    Elimina tutti i tentativi di riavvio.

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

Per altre informazioni, vedere Standard Installer Command-Line Options.

Suggerimento

Il programma di installazione restituisce un codice di uscita 0 per l'esito positivo e un codice di uscita 3010 per indicare che è necessario un riavvio. Qualsiasi altro valore è in genere un codice di errore.

Scaricare e installare manualmente

In alternativa ai programmi di Windows per .NET, è possibile scaricare e installare manualmente l'SDK o il runtime. L'installazione manuale viene in genere eseguita come parte dei test di integrazione continua. Per uno sviluppatore o un utente, è in genere consigliabile usare un programma di installazione.

Sia .NET SDK che .NET Runtime possono essere installati manualmente dopo che sono stati scaricati. Se si installa .NET SDK, non è necessario installare il runtime corrispondente. Per prima cosa, scaricare una versione binaria per l'SDK o il runtime da uno dei siti seguenti:

Creare una directory in cui estrarre .NET, ad esempio %USERPROFILE%\dotnet . Estrarre quindi il file ZIP scaricato in tale directory.

Per impostazione predefinita, le app e i comandi dell'interfaccia della riga di comando di .NET non usano .NET installato in questo modo ed è necessario sceglierlo in modo esplicito. A tale scopo, modificare le variabili di ambiente con cui viene avviata un'applicazione:

set DOTNET_ROOT=%USERPROFILE%\dotnet
set PATH=%USERPROFILE%\dotnet;%PATH%
set DOTNET_MULTILEVEL_LOOKUP=0

Questo approccio consente di installare più versioni in posizioni separate e quindi di scegliere in modo esplicito il percorso di installazione che un'applicazione deve usare eseguendo l'applicazione con variabili di ambiente che puntano a tale percorso.

Quando DOTNET_MULTILEVEL_LOOKUP è impostato su , 0 .NET ignora qualsiasi versione di .NET installata a livello globale. Rimuovere l'impostazione dell'ambiente per consentire a .NET di prendere in considerazione il percorso di installazione globale predefinito quando si seleziona il framework migliore per l'esecuzione dell'applicazione. Il valore predefinito è in genere , che è il punto in cui C:\Program Files\dotnet i programmi di installazione installano .NET.

Docker

I contenitori offrono un modo leggero per isolare l'applicazione dal resto del sistema host. I contenitori nello stesso computer condividono solo il kernel e usano le risorse fornite all'applicazione.

.NET può essere eseguito in un contenitore Docker. Le immagini Docker .NET ufficiali vengono pubblicate nel Microsoft Container Registry (MCR) e sono individuabili nel repository Microsoft .NET Docker Hub . Ogni repository contiene le immagini per diverse combinazioni di .NET (SDK o Runtime) e del sistema operativo che è possibile usare.

Microsoft fornisce immagini progettate per scenari specifici. Il repository di ASP.NET Core, ad esempio, include immagini che vengono compilate per l'esecuzione di app ASP.NET Core nell'ambiente di produzione.

Per altre informazioni sull'uso di .NET in un contenitore Docker, vedere Introduzione a .NET e Docker ed esempi.

Passaggi successivi