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 :

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

• Visual Studio

  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

• Programme d’installation .NET

  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.

• PowerShell

  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.

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.

Windows 7 / 8.1 / 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 :

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 :

• Installer Visual Studio.
• Configurer des charges de travail Visual Studio.

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.

Si Visual Studio est déjà installé, vous pouvez vérifier votre version en procédant comme suit.

1. Ouvrez Visual Studio.
2. Sélectionnez Aide>sur Microsoft Visual Studio.
3. 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.

1. Ouvrez un navigateur web et accédez à https://dotnet.microsoft.com/download/dotnet.

2. Sélectionnez la version de .NET que vous souhaitez télécharger, par exemple 9.0.

3. Recherchez la zone du kit de développement logiciel (SDK) ou du runtime qui contient les liens de téléchargement de .NET.

4. 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.

   

5. Ouvrez l’explorateur Windows et accédez à l’emplacement dans lequel le fichier a été téléchargé, probablement votre dossier Téléchargements.

6. Double-cliquez sur le fichier pour installer .NET.

   La boîte de dialogue de Windows Installer est ouverte.

   

7. 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-9.0.100-win-x64.exe /install /quiet /norestart

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.

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.

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.

• 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.

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
• 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 ASP.NET Core 8.0
• Microsoft.DotNet.DesktopRuntime.8—Runtime .NET Desktop 8.0
• Microsoft.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.

1. Installer WinGet.

2. Ouvrez un terminal, comme PowerShell ou une invite de commandes.

3. Exécutez la commande winget install et passez le nom du package du kit de développement logiciel (SDK) :

   winget install Microsoft.DotNet.SDK.9
   

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.

1. Installer WinGet.

2. Ouvrez un terminal, comme PowerShell ou une invite de commandes.

3. Exécutez la commande winget install et passez le nom du package du kit de développement logiciel (SDK) :

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

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         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 :

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.

1. Téléchargez le script depuis https://dot.net/v1/dotnet-install.ps1

2. Ouvrez PowerShell et accédez au dossier contenant le script.

3. 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.

1. Téléchargez le script depuis https://dot.net/v1/dotnet-install.ps1

2. Ouvrez PowerShell et accédez au dossier contenant le script.

3. Exécutez la commande suivante pour installer le kit de développement logiciel (SDK) .NET.

   dotnet-install.ps1
   

   Remarque

   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 :

1. 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 :

   

2. 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.

3. 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 :

   

4. Copiez le lien vers le fichier de somme de contrôle.

5. 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.txt
   

6. 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é :

   > (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
   

   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 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.dll est 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.

1. 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.exe
   

   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

2. 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.

   

3. La fenêtre Propriétés système s’ouvre sur l’onglet Avancé. Sélectionnez Variables d’environnement.

   

4. Dans la fenêtre Variables d’environnement, sous le groupe Variables système, sélectionnez la ligne Path*, puis sélectionnez le bouton Modifier.

   

5. 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).

Contenu connexe

• Vue d’ensemble de CLI .NET
• Mettre à niveau vers une nouvelle version de .NET.
• Comment vérifier que .NET est déjà installé.
• Tutoriel : tutoriel Hello World.
• Tutoriel : créer une application avec Visual Studio Code.