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.
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.
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.
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.
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 9 (Architectures)
.NET 8 (Architectures)
Windows 11 (24H2, 23H2, 22H2 Ent/Edu)
✔️ x64, x86, Arm64
✔️ x64, x86, Arm64
Windows 10 (22H2+)
✔️ x64, x86, Arm64
✔️ x64, x86, Arm64
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
Il n’existe plus de version de .NET prise en charge sur Windows 7 et Windows 8.1. Les dernières versions prises en charge étaient .NET 6 et la prise en charge a pris fin le 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 :
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 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 :
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
9
Visual Studio 2022 version 17.12 ou ultérieure.
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.
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.
Sélectionnez la version de .NET que vous souhaitez télécharger, par exemple 9.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.
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.
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.
Microsoft Update
Les exécutables du programme d’installation .NET sont des produits indépendants qui peuvent être gérés à l’aide de Microsoft Update (MU) sur Windows. MU est différent de Windows Update (WU), qui est utilisé pour traiter les composants du système d’exploitation comme .NET Framework.
Les correctifs de sécurité et non de sécurité pour les versions prises en charge de .NET sont fournis via mu à l’aide de plusieurs canaux de distribution. Les mises à jour automatiques (AU) concernent les utilisateurs finaux et les consommateurs, tandis que Windows Server Update Services (WSUS) et le catalogue Windows Update sont pertinents pour les administrateurs informatiques.
Les exécutables du programme d’installation .NET prennent en charge les installations côte à côte (SxS) entre les versions majeures et mineures pour différentes architectures et composants, tels que le runtime et le SDK. Par exemple, vous pouvez installer à la fois le runtime 6.0.15 (x64) et 6.0.17 (x86). Lorsque mu se déclenche, il offre le dernier programme d’installation pour les deux installations.
Bloquer les mises à jour
Bien que la plupart des utilisateurs préfèrent rester à jour, il est possible de bloquer les mises à jour .NET à l’aide des clés de Registre dans le tableau suivant.
Version de .NET
Clé de registre
Nom
Type
Value
Tous
HKLM\SOFTWARE\Microsoft\.NET
BlockMU
REG_DWORD
0x00000001
.NET 9
HKLM\SOFTWARE\Microsoft\.NET\9.0
BlockMU
REG_DWORD
0x00000001
.NET 8
HKLM\SOFTWARE\Microsoft\.NET\8.0
BlockMU
REG_DWORD
0x00000001
.NET 7
HKLM\SOFTWARE\Microsoft\.NET\7.0
BlockMU
REG_DWORD
0x00000001
.NET 6
HKLM\SOFTWARE\Microsoft\.NET\6.0
BlockMU
REG_DWORD
0x00000001
.NET 5
HKLM\SOFTWARE\Microsoft\.NET\5.0
BlockMU
REG_DWORD
0x00000001
.NET Core 3.1
HKLM\SOFTWARE\Microsoft\.NET\3.1
BlockMU
REG_DWORD
0x00000001
.NET Core 2.1
HKLM\SOFTWARE\Microsoft\.NET\2.1
BlockMU
REG_DWORD
0x00000001
Mises à jour automatiques pour le système d’exploitation du serveur
Les mises à jour des systèmes d’exploitation serveur sont prises en charge par WSUS et le catalogue Microsoft Update, mais pas par l’AUTHENTIFICATION. Les systèmes d’exploitation serveur peuvent choisir de recevoir des mises à jour via l’authentification unique à l’aide des clés de Registre suivantes.
Version de .NET
Clé de registre
Nom
Type
Value
Tous
HKLM\SOFTWARE\Microsoft\.NET
AllowAUOnServerOS
REG_DWORD
0x00000001
.NET 9
HKLM\SOFTWARE\Microsoft\.NET\9.0
AllowAUOnServerOS
REG_DWORD
0x00000001
.NET 8
HKLM\SOFTWARE\Microsoft\.NET\8.0
AllowAUOnServerOS
REG_DWORD
0x00000001
.NET 7
HKLM\SOFTWARE\Microsoft\.NET\7.0
AllowAUOnServerOS
REG_DWORD
0x00000001
.NET 6
HKLM\SOFTWARE\Microsoft\.NET\6.0
AllowAUOnServerOS
REG_DWORD
0x00000001
.NET 5
HKLM\SOFTWARE\Microsoft\.NET\5.0
AllowAUOnServerOS
REG_DWORD
0x00000001
.NET Core 3.1
HKLM\SOFTWARE\Microsoft\.NET\3.1
AllowAUOnServerOS
REG_DWORD
0x00000001
Choisir quand les versions précédentes sont supprimées
Les exécutables du programme d’installation installent toujours le nouveau contenu avant de supprimer l’installation précédente. Les applications en cours d’exécution peuvent être interrompues ou bloquées lorsque des runtimes plus anciens sont supprimés. Pour réduire l’impact de la mise à jour de .NET, vous pouvez spécifier quand une installation .NET précédente doit être supprimée à l’aide d’une clé de Registre.
Version de .NET
Clé de registre
Nom
Type
Value
Tous
HKLM\SOFTWARE\Microsoft\.NET
RemovePreviousVersion
REG_SZ
always, never ou nextSession
.NET 9
HKLM\SOFTWARE\Microsoft\.NET\9.0
RemovePreviousVersion
REG_SZ
always, never ou nextSession
.NET 8
HKLM\SOFTWARE\Microsoft\.NET\8.0
RemovePreviousVersion
REG_SZ
always, never ou nextSession
never conserve les installations précédentes et nécessite une intervention manuelle pour supprimer les installations .NET précédentes.
always supprime les installations précédentes après l’installation de la nouvelle version. Il s’agit du comportement par défaut dans .NET.
nextSession reporte la suppression jusqu’à la prochaine session d’ouverture de session des membres du groupe Administrateurs.
Les valeurs ne respectent pas la casse et ne sont pas valides par défaut always.
Lorsque la suppression est différée, le programme d’installation écrit une commande dans la clé de Registre RunOnce pour désinstaller la version précédente. La commande s’exécute uniquement si un utilisateur du groupe Administrateurs se connecte à l’ordinateur.
Notes
Cette fonctionnalité est disponible uniquement dans .NET 8 (8.0.11), 9 et versions ultérieures de .NET. Il s’applique uniquement aux exécutables du programme d’installation autonome et affecte les distributions telles que WinGet qui les utilisent.
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.9—.NET Runtime 9.0
Microsoft.DotNet.AspNetCore.9— ASP.NET Core Runtime 9.0
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.
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 :
Invite de commandes Windows
winget search Microsoft.DotNet.SDK
Les résultats de la recherche sont édités dans une table contenant chaque identificateur de package.
Output
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
Installer des préversions
Si une version préliminaire est disponible, remplacez le numéro de version dans l’ID par le mot Preview. L’exemple suivant installe la version préliminaire du Runtime .NET Desktop :
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.
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 :
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é :
Avec 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é :
Si 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 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.
S’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).
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :
.NET est une plateforme de développement, gratuite, multiplateforme et open source permettant de créer de nombreux types d’applications différents. Avec .NET, vous pouvez utiliser plusieurs langages, éditeurs et bibliothèques afin de créer pour le web, les appareils mobiles, les postes de travail, les jeux et IoT.