Installer .NET sur Windows
Cet article vous explique quelles versions de .NET sont prises en charge sur Windows, comment installer .NET et quelle est la différence entre le SDK et le runtime.
Contrairement à .NET Framework, .NET n’est pas lié à votre version de Windows. Vous ne pouvez avoir qu’une seule version de .NET Framework installée sur Windows. Cependant, .NET est autonome et peut être installé n’importe où sur votre ordinateur. Certaines applications peuvent inclure leur propre copie de .NET.
Par défaut, .NET est installé dans le répertoire Program Files\dotnet sur votre ordinateur, sauf si la méthode d’installation choisit un autre répertoire.
.NET est constitué du runtime et du kit SDK. Le runtime exécute des applications .NET et le kit de développement logiciel (SDK) est utilisé pour créer des applications.
Choisir le bon runtime
Il existe trois runtimes différents pour Windows qui permettent l’exécution de différents types d’applications. Le SDK inclut les trois runtimes, et un installateur pour un runtime peut inclure un runtime supplémentaire. Le tableau suivant décrit le runtime inclus dans un programme d’installation .NET particulier :
| Programme d’installation | Inclut le runtime .NET | Inclut le runtime .NET Desktop | Inclut le runtime ASP.NET Core |
|---|---|---|---|
| .NET Runtime | Oui | No | Non |
| Runtime .NET Desktop | Oui | Oui | Non |
| Runtime ASP.NET Core | Non | Non | Oui |
| Kit de développement logiciel (SDK) .NET | Oui | Oui | Oui |
Pour vous assurer de pouvoir exécuter toutes les applications .NET sur Windows, installez ASP.NET Core Runtime et .NET Desktop Runtime. Le runtime ASP.NET Core exécute des applications basées sur le web, et le runtime .NET Desktop exécute des applications de bureau, telles qu’une application Windows Presentation Foundation (WPF) ou Windows Forms.
Choisir comment installer .NET
Il existe différentes manières d’installer .NET, et certains produits peuvent gérer leur propre version de .NET. Si vous installez .NET via un logiciel qui gère sa propre version de .NET, il se peut qu’il ne soit pas activé pour l’ensemble du système. Assurez-vous de comprendre les implications de l’installation de .NET via d’autres logiciels.
Si vous ne savez pas quelle méthode choisir après avoir examiné les listes des sections suivantes, vous souhaitez probablement utiliser le programme d’installation .NET.
Développeurs
-
Utilisez Visual Studio pour installer .NET lorsque vous souhaitez développer des applications .NET à l’aide de Visual Studio. Visual Studio gère sa propre copie de .NET. Cette méthode installe le kit de développement logiciel (SDK), le runtime et les modèles Visual Studio.
Visual Studio Code - Kit de développement C#
Installez l’extension du kit de développement C# pour Visual Studio Code afin de développer des applications .NET. L’extension peut utiliser un SDK déjà installé ou en installer un pour vous.
Utilisateurs et développeurs
-
Installez .NET avec un package Windows Installer, qui est un exécutable que vous exécutez. Cette méthode peut installer le kit de développement logiciel (SDK) et le runtime. Les installations sont effectuées à l’échelle du système.
Gestionnaire de package Windows (WinGet)
Utilisez WinGet pour installer .NET lorsque vous souhaitez gérer .NET via la ligne de commande. Cette méthode peut installer le kit de développement logiciel (SDK) et le runtime. Les installations sont effectuées à l’échelle du système.
-
Script PowerShell pouvant automatiser l’installation du kit de développement logiciel (SDK) ou du runtime. Vous pouvez choisir la version de .NET à installer.
Versions prises en charge
Le tableau suivant répertorie les versions .NET actuellement prises en charge et les versions de Windows sur lesquelles elles sont prises en charge. Ces versions restent prises en charge jusqu’à ce que la version de .NET atteigne la fin de prise en charge ou que la version de Windows atteigne la fin de vie.
Conseil
Pour rappel, ce tableau s’applique au .NET actuel (par opposition à .NET Framework). Pour installer .NET Framework, consultez le Guide d’installation de .NET Framework.
Les dates de fin de service des versions de Windows 10 sont segmentées par édition. Seules les éditions Home, Pro,Pro Educationet Pro pour stations de travail sont prises en compte dans le tableau suivant. Consultez Cycle de vie Windows pour plus d’informations.
| Système d’exploitation | .NET 8 (Architectures) | .NET 6 (Architectures) |
|---|---|---|
| Windows 11 (24H2, 23H2, 22H2 Ent/Edu) | ✔️ x64, x86, Arm64 | ✔️ x64, Arm64 |
| Windows 10 (22H2+) | ✔️ x64, x86, Arm64 | ✔️ x64, x86, Arm64 |
| Windows 8.1 | ❌ | ✔️ x64, x86 |
| Windows 7 SP1 ESU | ❌ | ✔️ x64, x86 |
| Windows Server 2025 Windows Server 2022 Windows Server 2019 Windows Server, version 1903 ou ultérieure Windows Server 2016 Windows Server 2012 R2 Windows Server 2012 |
✔️ x64, x86 | ✔️ x64, x86 |
| Windows Server Core 2012 (et R2) | ✔️ x64, x86 | ✔️ x64, x86 |
| Nano Server (2022, 2019) | ✔️ x64 | ✔️ x64 |
Conseil
Un symbole + représente la version minimale.
Windows 7 / 8.1 / Server 2012
Windows 7 et Windows 8.1 prennent uniquement en charge .NET 6. Toutefois, .NET 6 n’est pas pris en charge à partir du 12 novembre 2024.
Windows Server 2012 est toujours pris en charge par n’importe quelle version de .NET qui est toujours prise en charge.
Ces trois versions de Windows nécessitent l’installation de dépendances supplémentaires :
| Système d’exploitation | Prérequis |
|---|---|
| Windows 7 SP1 ESU | - Microsoft Visual C++ 2015-2019 Redistribuable 64 bits / 32 bits - KB3063858 64-bit / 32-bit - Autorité de certification racine Microsoft 2011 (programme d’installation hors connexion .NET Core 2.1 uniquement) |
| Windows 8.1 | Microsoft Visual C++ 2015-2019 Redistribuable 64 bits / 32 bits |
| Windows Server 2012 | Microsoft Visual C++ 2015-2019 Redistribuable 64 bits / 32 bits |
| Windows Server 2012 R2 | Microsoft Visual C++ 2015-2019 Redistribuable 64 bits / 32 bits |
Les exigences précédentes sont également requises si vous recevez une erreur liée à l’une des DLL suivantes :
- api-ms-win-crt-runtime-l1-1-0.dll
- api-ms-win-cor-timezone-l1-1-0.dll
- hostfxr.dll
PC Windows ARM
.NET est pris en charge sur les PC Windows arm. Les sections suivantes décrivent les éléments à prendre en compte lors de l’installation de .NET.
Différences entre les SDK
Les versions x86, x64 et Arm64 du kit de développement logiciel (SDK) .NET existent indépendamment les unes des autres. Si une nouvelle version est publiée, chaque installation d’architecture doit être mise à niveau.
Différences de chemin d’accès
Sur un PC Windows ARM, toutes les versions arm64 de .NET sont installées dans le dossier C:\Program Files\dotnet\ habituel. Toutefois, la version x64 du Kit de développement logiciel (SDK) .NET est installée dans le dossier C:\Program Files\dotnet\x64\.
Variables de chemin d’accès
Les variables d'environnement qui ajoutent .NET au chemin du système, telles que la variable PATH, doivent être modifiées si les versions x64 et Arm64 du kit de développement logiciel (SDK) .NET sont installées. En outre, certains outils s’appuient sur la variable d’environnement DOTNET_ROOT, qui doit également être mise à jour pour pointer vers le dossier d’installation du Kit de développement logiciel (SDK) .NET approprié.
Installer avec Visual Studio
Visual Studio installe sa propre copie de .NET distincte des autres copies de .NET. Différentes versions de Visual Studio prennent en charge différentes versions de .NET. La dernière version de Visual Studio prend toujours en charge la dernière version de .NET.
Visual Studio Installer installe et configure Visual Studio. Certaines charges de travail Visual Studio incluent .NET, comme ASP.NET et le développement web et le développement de .NET Multi-Platform App UI. Des versions spécifiques de .NET peuvent être installées via l’onglet Composants individuels.
La documentation Visual Studio fournit des instructions sur les points suivants :
Versions .NET et Visual Studio
Si vous utilisez Visual Studio pour développer des applications .NET, le tableau suivant décrit la version minimale de Visual Studio requise en fonction de la version cible du Kit de développement logiciel (SDK) .NET.
| Version du Kit de développement logiciel (SDK) .NET | Version Visual Studio |
|---|---|
| 8 | Visual Studio 2022 version 17.8 ou ultérieure. |
| 7 | Visual Studio 2022 version 17.4 ou ultérieure. |
| 6 | Visual Studio 2022 version 17.0 ou ultérieure. |
| 5 | Visual Studio 2019 version 16.8 ou ultérieure. |
| 3.1 | Visual Studio 2019 version 16.4 ou ultérieure. |
| 3.0 | Visual Studio 2019 version 16.3 ou ultérieure. |
| 2.2 | Visual Studio 2017 version 15.9 ou ultérieure. |
| 2.1 | Visual Studio 2017 version 15.7 ou ultérieure. |
Si Visual Studio est déjà installé, vous pouvez vérifier votre version en procédant comme suit.
- Ouvrez Visual Studio.
- Sélectionnez Aide>sur Microsoft Visual Studio.
- Lisez le numéro de version de la boîte de dialogue À propos.
Pour plus d’informations, consultez le Contrôle de version du kit de développement logiciel (SDK) .NET, de MSBuild et de Visual Studio.
Installer avec Visual Studio Code
Visual Studio Code est un éditeur de code source puissant et léger qui s’exécute sur votre bureau. Visual Studio Code peut utiliser le SDK déjà installé sur votre système. De plus, l’extension C# Dev Kit installera .NET pour vous s’il n’est pas déjà installé.
Pour obtenir des instructions sur l’installation de .NET via Visual Studio Code, consultez la rubrique Premiers pas avec C# dans VS Code.
Programme d’installation .NET
La page de téléchargement de .NET fournit des exécutables Windows Installer.
Ouvrez un navigateur web et accédez à https://dotnet.microsoft.com/download/dotnet.
Sélectionnez la version de .NET que vous souhaitez télécharger, par exemple 8.0.
Recherchez la zone du kit de développement logiciel (SDK) ou du runtime qui contient les liens de téléchargement de .NET.
Sous la colonne Programmes d’installation, recherchez la ligne Windows et sélectionnez le lien de votre architecture UC. Si vous ne la connaissez pas, sélectionnez x64, car c’est la plus courante.
Le navigateur devrait télécharger automatiquement l’installateur.
Conseil
L’image suivante montre le kit de développement logiciel (SDK), mais vous pouvez également télécharger le runtime.
Ouvrez l’explorateur Windows et accédez à l’emplacement dans lequel le fichier a été téléchargé, probablement votre dossier Téléchargements.
Double-cliquez sur le fichier pour installer .NET.
La boîte de dialogue de Windows Installer est ouverte.
Sélectionnez Installer et suivez les instructions pour installer .NET.
Pour apprendre à utiliser l’interface CLI .NET, consultez Vue d’ensemble de l’interface CLI .NET.
Options de ligne de commande
Utilisez le paramètre /? pour afficher une liste d’options.
Si vous souhaitez installer .NET silencieusement, par exemple dans un environnement de production ou pour prendre en charge une intégration continue, utilisez les options suivantes :
/install
Installe .NET./quiet
Empêche l’affichage d’une interface utilisateur et d’une invite./norestart
Supprime toute tentative de redémarrage.
dotnet-sdk-8.0.100-win-x64.exe /install /quiet /norestart
Conseil
Le programme d’installation retourne un code de sortie de 0 pour succès et un code de sortie de 3010 pour indiquer qu’un redémarrage est requis. Toute autre valeur est probablement un code d’erreur.
Installer avec le Gestionnaire de package Windows (WinGet)
Vous pouvez installer et gérer .NET via le service Gestionnaire de package Windows à l’aide de l’outil winget.exe. Pour plus d’informations sur l’installation et l’utilisation de WinGet, consultez Utiliser l’outil WinGet pour installer et gérer des applications.
Si vous installez .NET à l’échelle du système, installez-le avec des privilèges d’administration.
Les packages WinGet de .NET sont les suivants :
Microsoft.DotNet.Runtime.8—Runtime .NET 8.0.Microsoft.DotNet.AspNetCore.8—Runtime ASP.NET Core 8.0Microsoft.DotNet.DesktopRuntime.8—Runtime .NET Desktop 8.0Microsoft.DotNet.SDK.8—Kit de développement logiciel (SDK) .NET 8.0
Installer le SDK
Si vous installez le SDK , vous n’avez pas besoin d’installer le runtime correspondant.
Ouvrez un terminal, comme PowerShell ou une invite de commandes.
Exécutez la commande
winget installet passez le nom du package du kit de développement logiciel (SDK) :winget install Microsoft.DotNet.SDK.8
Pour apprendre à utiliser l’interface CLI .NET, consultez Vue d’ensemble de l’interface CLI .NET.
Installer le runtime
Il existe différents runtimes que vous pouvez installer. Reportez-vous à la section Choisir le bon runtime pour comprendre ce qui est inclus dans chaque runtime.
Ouvrez un terminal, comme PowerShell ou une invite de commandes.
Exécutez la commande
winget installet passez le nom du package du kit de développement logiciel (SDK) :winget install Microsoft.DotNet.DesktopRuntime.8 winget install Microsoft.DotNet.AspNetCore.8
Pour apprendre à utiliser l’interface CLI .NET, consultez Vue d’ensemble de l’interface CLI .NET.
Rechercher des versions
Utilisez la commande winget search pour rechercher les différentes versions du package que vous souhaitez installer. Par exemple, la commande suivante recherche tous les kits de développement logiciel (SDK) .NET disponibles via WinGet :
winget search Microsoft.DotNet.SDK
Les résultats de la recherche sont édités dans une table contenant chaque identificateur de package.
Name Id Version Source
----------------------------------------------------------------------------------------------
Microsoft .NET SDK 9.0 Preview Microsoft.DotNet.SDK.Preview 9.0.100-preview.3.24204.13 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
Installer des préversions
Vous pouvez installer des préversions en remplaçant le numéro de version, tel que 8, par le mot Preview. L’exemple suivant installe la version préliminaire du Runtime .NET Desktop :
winget install Microsoft.DotNet.DesktopRuntime.Preview
Installer avec PowerShell
L’installation de .NET via le script PowerShell dotnet-install est recommandée pour une intégration continue et des installations effectuées par des non administrateurs. Si vous installez .NET pour une utilisation normale sur votre système, utilisez les méthodes d’installation .NET Installer ou le Gestionnaire de package Windows .
Par défaut, le script installe la dernière version en support à long terme (LTS), qui est .NET 8. Vous pouvez choisir une version spécifique en spécifiant le commutateur -Channel. Incluez le commutateur -Runtime pour installer un runtime. Sinon, le script installe le SDK. Le script est disponible à l’adresse https://dot.net/v1/dotnet-install.ps1 et le code source est hébergé sur GitHub.
Pour plus d’informations sur le script, consultez Référence du script d’installation de .NET.
Installer le runtime
Le runtime .NET est installé en fournissant le commutateur -Runtime.
Téléchargez le script depuis https://dot.net/v1/dotnet-install.ps1
Ouvrez PowerShell et accédez au dossier contenant le script.
Exécutez la commande suivante pour installer les runtimes ASP.NET Core et Desktop pour une compatibilité maximale :
dotnet-install.ps1 -Runtime windowsdesktop dotnet-install.ps1 -Runtime aspnetcore
Pour apprendre à utiliser l’interface CLI .NET, consultez Vue d’ensemble de l’interface CLI .NET.
Installer le SDK
Si vous installez le kit de développement logiciel (SDK), vous n’avez pas besoin d’installer les runtimes.
Téléchargez le script depuis https://dot.net/v1/dotnet-install.ps1
Ouvrez PowerShell et accédez au dossier contenant le script.
Exécutez la commande suivante pour installer le kit de développement logiciel (SDK) .NET.
dotnet-install.ps1Remarque
Le kit de développement logiciel (SDK) est installé en omettant le commutateur
-Runtime.
Pour apprendre à utiliser l’interface CLI .NET, consultez Vue d’ensemble de l’interface CLI .NET.
Validation
Après avoir téléchargé un programme d’installation ou une version binaire, vérifiez-le pour vous assurer que le fichier n’a pas été modifié ou corrompu. Vous pouvez vérifier la somme de contrôle sur votre ordinateur, puis la comparer à ce qui a été signalé sur le site web de téléchargement.
Lorsque vous téléchargez le fichier depuis une page de téléchargement officielle, la somme de contrôle du fichier est affichée dans une zone de texte. Sélectionnez le bouton Copier pour copier la valeur de la somme de contrôle dans votre presse-papiers.
Vous pouvez utiliser PowerShell ou l’invite de commandes pour valider la somme de contrôle du fichier que vous avez téléchargé. Par exemple, la commande suivante signale la somme de contrôle du fichier 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
Comparez la somme de contrôle avec la valeur fournie par le site de téléchargement.
Utiliser PowerShell et un fichier de somme de contrôle pour la validation
Les notes de publication de .NET contiennent un lien vers un fichier de somme de contrôle que vous pouvez utiliser pour valider votre fichier téléchargé. Les étapes suivantes décrivent comment télécharger le fichier de somme de contrôle et valider un fichier binaire d’installation .NET :
La page des notes de publication de .NET 8 sur GitHub sur https://github.com/dotnet/core/tree/main/release-notes/8.0 contient une section nommée Versions. Le tableau de cette section contient des liens vers les fichiers de téléchargement et de somme de contrôle pour chaque version de .NET 8 :
Sélectionnez le lien correspondant à la version de .NET que vous avez téléchargée. La section précédente utilise le kit de développement logiciel (SDK) .NET 8.0.100, qui se trouve dans la version .NET 8.0.0.
Conseil
Si vous ne savez pas quelle version de .NET contient votre fichier de somme de contrôle, explorez les liens jusqu’à ce que vous le trouviez.
Dans la page de publication, vous pouvez voir la version du runtime .NET et du SDK .NET, ainsi qu’un lien vers le fichier de somme de contrôle :
Copiez le lien vers le fichier de somme de contrôle.
Utilisez le script suivant, mais remplacez le lien pour télécharger le fichier de somme de contrôle approprié :
Invoke-WebRequest https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt -OutFile 8.0.0-sha.txtAvec le fichier de somme de contrôle et le fichier de version .NET téléchargés dans le même répertoire, recherchez dans le fichier de somme de contrôle la somme de contrôle du téléchargement .NET :
Dès que la validation réussit, vous voyez True imprimé :
> (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 + "*" TrueSi vous voyez False imprimé, le fichier que vous avez téléchargé n’est pas valide et ne doit pas être utilisé.
Dépannage
Après avoir installé le kit de développement logiciel (SDK) .NET, vous pouvez rencontrer des problèmes en tentant d’exécuter des commandes CLI .NET. Cette section collecte ces problèmes courants et fournit des solutions.
- Aucun Kit de développement logiciel (SDK) .NET n’a été trouvé
- La création d’applications est plus lente que prévu
hostfxr.dll/api-ms-win-crt-runtime-l1-1-0.dll/api-ms-win-cor-timezone-l1-1-0.dllest manquant
Aucun Kit de développement logiciel (SDK) .NET n’a été trouvé
La raison probable est que vous avez installé à la fois la version x86 (32 bits) et la version x64 (64 bits) du Kit de développement logiciel (SDK) .NET. Cela provoque un conflit, car lorsque vous exécutez la commande dotnet, elle est résolue en version x86 alors qu’elle devrait être résolue en version x64. Ce problème est corrigé en ajustant la variable %PATH% pour résoudre d’abord en version x64.
Vérifiez que les deux versions sont installées en exécutant la commande
where.exe dotnet. Après cela, vous devez voir une entrée pour les dossiers Program Files\ et Program Files (x86)\. Si le dossier Program Files (x86)\ est d’abord indiqué, comme indiqué par l’exemple suivant, il y a une erreur et vous devez passer à l’étape suivante.> where.exe dotnet C:\Program Files (x86)\dotnet\dotnet.exe C:\Program Files\dotnet\dotnet.exeS’il n’y a pas d’erreur et que program Files\ est en premier, vous n’avez pas le problème que cette section traite et vous pouvez créer une demande d’aide .NET sur GitHub
Appuyez sur le bouton Windows et tapez « Modifier les variables d’environnement système » dans la barre de recherche. Sélectionnez Modifier les variables d’environnement système.
La fenêtre Propriétés système s’ouvre sur l’onglet Avancé. Sélectionnez Variables d’environnement.
Dans la fenêtre Variables d’environnement, sous le groupe Variables système, sélectionnez la ligne Path*, puis sélectionnez le bouton Modifier.
Utilisez les boutons Déplacer vers le haut et Déplacer vers le bas pour déplacer l’entrée C:\Program Files\dotnet\ au-dessus de C:\Program Files (x86)\dotnet\.
La création d’applications est plus lente que prévu
Vérifiez que Smart App Control, une fonctionnalité Windows, est désactivée. Il n’est pas recommandé d’activer Smart App Control sur les ordinateurs utilisés pour le développement. Un paramétrage autre que « Désactivée » peut avoir un impact négatif sur les performances du kit de développement logiciel (SDK).
hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll est manquant
Installez Microsoft Visual C++ 2015-2019 Redistribuable (64 bits ou 32 bits).
