Partage via

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

Important

Si vous installez .NET sur l'ensemble du système, installez-le avec des droits administratifs.

.NET est constitué du runtime et du Kit de développement logiciel (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 l'environnement d'exécution .NET de bureau Inclut ASP.NET Core Runtime
.NET Runtime Oui Non Non
.NET Desktop Runtime Oui Oui Non
ASP.NET Core Runtime Non Non Oui
.NET SDK Oui Oui Oui

Pour vous assurer que vous pouvez exécuter toutes les applications .NET sur Windows, installez à la fois le runtime ASP.NET Core et le runtime de bureau .NET. Le runtime ASP.NET Core exécute des applications web, et le runtime de bureau .NET exécute des applications de bureau, telles qu’un Windows Presentation Foundation (WPF) ou une application Windows Forms.

Choisir la méthode d'installation de .NET

Il existe différentes façons 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é à l’échelle du système. Veillez à comprendre les implications de l’installation de .NET via d’autres logiciels.

Si vous ne savez pas quelle méthode vous devez choisir après avoir examiné les listes dans les sections suivantes, vous souhaitez probablement utiliser le programme d'installation .NET Installer.

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 les modèles SDK, Runtime et Visual Studio.

  • Visual Studio Code - Kit de développement C#

    Installez l’extension C# Dev Kit pour Visual Studio Code pour 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.

  • Windows Gestionnaire de package (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 de .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 atteint la fin de vie.

Conseil

Comme rappel, ce tableau s’applique aux .NET modernes (par opposition à .NET Framework). Pour installer .NET Framework, consultez le guide d’installation .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. Pour des détails précis, consultez la feuille d'information sur le cycle de vie de Windows.

Système d’exploitation .NET 10 (architectures) .NET 9 (Architectures) .NET 8 (Architectures)
Windows 11 (24H2, 23H2, 22H2 Ent/Edu) ✔️ x64, Arm64 ✔️ x64, Arm64 ✔️ x64, Arm64
Windows 10 (22H2) ✔️ x64, Arm64 ✔️ x64, Arm64 ✔️ x64, 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		 ✔️ x64, x86 ✔️ x64, x86 ✔️ x64, x86
Windows Server Core 2012 (et R2) ✔️ x64, x86 ✔️ x64, x86 ✔️ x64, x86
Nano Server (2025, 2022, 2019) ✔️ x64 ✔️ x64 ✔️ x64
Windows 8.1 ❌ ❌ ❌
Windows 7 SP1 ESU ❌ ❌ ❌

Conseil

Un symbole représente la version minimale.

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 ont été .NET 6 et le support a pris fin le 12 novembre 2024.

Windows Server 2012 est toujours pris en charge par n'importe quelle version de .NET toujours prise en charge.

Les trois versions de ces 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 bits32 bits
- KB3063858 64 bits
- Microsoft Root Certificate Authority 2011 (programme d’installation hors connexion .NET Core 2.1 uniquement)
Windows 8.1 Microsoft Visual C++ 2015-2019 Redistributable 64 bits32 bits
Windows Server 2012 Microsoft Visual C++ 2015-2019 Redistributable 64 bits32 bits
Windows Server 2012 R2 Microsoft Visual C++ 2015-2019 Redistributable 64 bits32 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

Ordinateurs Windows basés sur ARM

.NET est pris en charge sur les PC Windows basés sur ARM. Les sections suivantes décrivent les éléments à prendre en compte lors de l’installation de .NET.

Différences de parcours

Sur un PC Windows arm, toutes les versions d’Arm64 de .NET sont installées dans le dossier normal C :\Program Files\dotnet\. Toutefois, la version x64 du 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 d’accès système, telles que la variable PATH, peuvent être modifiées si vous avez à la fois les versions x64 et Arm64 du SDK .NET 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 approprié .NET SDK.

Installer avec Visual Studio

Visual Studio installe sa propre copie de .NET distincte d’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.

Download Visual Studio Installer

Visual Studio Installer installe et configure Visual Studio. Certaines charges de travail Visual Studio incluent des .NET, telles que ASP.NET et le développement web et .NET développement d’interface utilisateur d’application multiplateforme. Des versions spécifiques de .NET peuvent être installées via l’onglet Individual Components.

La documentation Visual Studio fournit des instructions sur la façon de :

Une capture d’écran montrant Visual Studio Installer avec la charge de travail .NET Desktop surlignée dans une zone rouge.

versions .NET et Visual Studio

Si vous utilisez Visual Studio pour développer des applications .NET, le tableau suivant décrit la version minimale requise de Visual Studio en fonction de la version cible .NET SDK.

version du KIT de développement logiciel (SDK) .NET version de Visual Studio
10 Visual Studio 2026 version 18.0 ou ultérieure.
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 vous avez déjà installé Visual Studio, vous pouvez vérifier votre version en procédant comme suit.

  1. Ouvrez Visual Studio.
  2. Sélectionnez Help>About Microsoft Visual Studio.
  3. Lisez le numéro de version de la boîte de dialogue À propos.

Pour plus d’informations, consultez .NET SDK, MSBuild et Visual Studio contrôle de version.

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.

Important

Si vous installez .NET sur l'ensemble du système, installez-le avec des privilèges administratifs.

Ce fichier de configuration WinGet installe les derniers sdk .NET, Visual Studio Code et C# DevKit. Si vous avez déjà installé l’un d’eux, WinGet ignore cette étape.

  1. Téléchargez le fichier et double-cliquez pour l’exécuter.
  2. Lisez le contrat de licence, tapez et, puis sélectionnez Entrer lorsque vous êtes invité à accepter.
  3. Si vous recevez une invite de contrôle de compte d’utilisateur (UAC) qui clignote dans votre barre des tâches, autorisez la poursuite de l'installation.

En outre, l'extension C# Dev Kit installe .NET pour vous si elle n'est pas déjà installée.

Pour obtenir des instructions sur l’installation de .NET via Visual Studio Code, consultez Getting Started with C# in VS Code.

programme d’installation de .NET

La page download pour .NET fournit des exécutables Windows Installer.

Important

Si vous installez .NET sur l'ensemble du système, installez-le avec des droits administratifs.

  1. Ouvrez un navigateur web et accédez à https://.

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

  3. Recherchez la zone SDK ou Runtime qui contient les liens permettant de télécharger .NET.

  4. Sous la colonne Installers, recherchez la ligne Windows et sélectionnez le lien pour votre architecture processeur. 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.

    Imagean de la page de téléchargement .NET, avec le lien de téléchargement du SDK mis en surbrillance.

  5. Ouvrez Windows Explorer et accédez à l’emplacement où le fichier a été téléchargé, probablement votre dossier Downloads.

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

    La boîte de dialogue de l'installateur Windows est ouverte.

    Une capture d'écran de la fenêtre de l'application d'installation .NET.

  7. Sélectionnez Install et suivez les instructions pour installer .NET.

Pour savoir comment utiliser l’interface CLI .NET, consultez .NET vue d’ensemble de l’interface CLI.

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 l’intégration continue, utilisez les options suivantes :

  • /install
    Installe .NET.

  • /quiet
    Empêche l’affichage d’une interface utilisateur et d’un message d'invite.

  • /norestart
    Supprime toute tentative de redémarrage.

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

Si vous avez déjà installé .NET, utilisez le programme d'installation .NET pour gérer l'installation. Au lieu de , utilisez l'une des options suivantes :

  • /uninstall
    Supprimez cette version de .NET.

  • /repair
    Vérifiez si les fichiers clés ou les composants de l'installation sont endommagés et restaurez-les.

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.

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 Windows Update catalogue 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 Kit de développement logiciel (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 proposera le dernier programme d'installation pour chaque installation.

Bloquer les mises à jour

Bien que la plupart des utilisateurs préfèrent être tenus à jour, il est possible de bloquer .NET mises à jour à l’aide des clés de Registre dans le tableau suivant.

version .NET Clé de registre Nom Catégorie Valeur
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 AU. 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 .NET Clé de registre Nom Catégorie Valeur
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 PermettreAU sur OS Serveur 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

Classifications WSUS et mises à jour

WSUS peut être configuré pour fournir des mises à jour spécifiques en fonction de leur classification. Les mises à jour des .NET sont classées comme security ou critique. Si la dernière mise à jour est classifiée comme critique, une mise à jour antérieure security peut être proposée lorsqu'une version antérieure de .NET est installée remplacée par la dernière mise à jour de sécurité. Cela s’applique également à l’utilisation du cab hors connexion (Wsusscan2.cab) pour analyser un ordinateur.

Remarque

Dans certains cas, WSUS peut signaler une mise à jour manquante pour une version antérieure à la version .NET que vous avez installée. Par exemple, imaginez qu’un utilisateur installe .NET 6.0.36, la dernière version de .NET 6. Cette version est classée comme une mise à jour critique (non de sécurité). Ensuite, une application installe une version antérieure, 6.0.33. (Il n'est pas rare que les applications incluent des versions spécifiques de .NET en tant que prérequis.) Si un administrateur a configuré WSUS pour fournir uniquement des mises à jour de sécurité, l’analyse suivante signale la version 6.0.35 comme une mise à jour manquante. Les machines configurées pour recevoir des mises à jour de sécurité via AU ou WSUS sont proposées 6.0.35, même lorsque la version 6.0.36 est installée. La raison en est que la version 6.0.35 remplace 6.0.33 et est la dernière mise à jour de sécurité .

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 .NET, vous pouvez spécifier quand une installation de .NET précédente doit être supprimée à l’aide d’une clé de Registre.

version .NET Clé de registre Nom Catégorie Valeur
Tous HKLM\SOFTWARE\Microsoft\.NET SupprimerVersionPrécédente REG_SZ , ou
.NET 10 HKLM\SOFTWARE\Microsoft\.NET\10.0 SupprimerVersionPrécédente REG_SZ , ou
.NET 9 HKLM\SOFTWARE\Microsoft\.NET\9.0 SupprimerVersionPrécédente REG_SZ , ou
.NET 8 HKLM\SOFTWARE\Microsoft\.NET\8.0 SupprimerVersionPrécédente REG_SZ , ou
  • never conserve les installations précédentes et nécessite une intervention manuelle pour supprimer les installations de .NET précédentes.
  • supprime les installations précédentes après l’installation de la nouvelle version. Il s’agit du comportement par défaut dans .NET.
  • reporte la suppression jusqu'à la prochaine connexion des membres du groupe Administrateurs.
  • Les valeurs sont insensibles à la casse et les valeurs non valides sont définies par défaut sur .

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.

Remarque

Cette fonctionnalité est disponible uniquement à partir de .NET 8 (8.0.11). Il s’applique uniquement aux exécutables du programme d’installation autonome et affecte les distributions telles que WinGet qui les utilisent.

Installer avec Windows Gestionnaire de package (WinGet)

Vous pouvez installer et gérer des .NET via le service Windows Gestionnaire de package, à 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.

Important

Si vous installez .NET sur l'ensemble du système, installez-le avec des droits administratifs.

Les packages WinGet .NET sont les suivants :

  • Microsoft.DotNet.Runtime.10 : .NET Runtime 10.0
  • Microsoft.DotNet.AspNetCore.10 : ASP.NET Core Runtime 10.0
  • Microsoft.DotNet.DesktopRuntime.10 : .NET Desktop Runtime 10.0
  • Microsoft.DotNet.SDK.10— SDK .NET 10.0
  • 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 : ASP.NET Core Runtime 8.0
  • Microsoft.DotNet.DesktopRuntime.8 : .NET Desktop Runtime 8.0
  • Microsoft.DotNet.SDK.8—.NET SDK 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 et passez le nom du package du kit de développement logiciel (SDK) :

    winget install Microsoft.DotNet.SDK.10

Pour savoir comment utiliser l’interface CLI .NET, consultez .NET vue d’ensemble de l’interface CLI.

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 et passez le nom du package du kit de développement logiciel (SDK) :

    winget install Microsoft.DotNet.DesktopRuntime.10
winget install Microsoft.DotNet.AspNetCore.10

Pour savoir comment utiliser l’interface CLI .NET, consultez .NET vue d’ensemble de l’interface CLI.

Rechercher des versions

Utilisez la commande pour rechercher les différentes versions du package que vous souhaitez installer. Par exemple, la commande suivante recherche tous les kits 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 3.1          Microsoft.DotNet.SDK.3_1     3.1.426                 winget
Microsoft .NET SDK 5.0          Microsoft.DotNet.SDK.5       5.0.408                 winget
Microsoft .NET SDK 6.0          Microsoft.DotNet.SDK.6       6.0.428                 winget
Microsoft .NET SDK 7.0          Microsoft.DotNet.SDK.7       7.0.410                 winget
Microsoft .NET SDK 8.0          Microsoft.DotNet.SDK.8       8.0.415                 winget
Microsoft .NET SDK 9.0          Microsoft.DotNet.SDK.9       9.0.306                 winget
Microsoft .NET SDK 10.0         Microsoft.DotNet.SDK.10      10.0.100                winget

Installer des préversions

Si une version préliminaire est disponible, remplacez le numéro de version dans l’ID par le mot . L’exemple suivant installe la préversion du runtime de bureau .NET :

winget install Microsoft.DotNet.DesktopRuntime.Preview

Installer avec PowerShell

L’installation de .NET via le script PowerShell dotnet-install est recommandée pour l’intégration continue et les installations non administrateurs. Si vous installez .NET pour une utilisation normale sur votre système, utilisez les méthodes d'installation .NET Installer ou Windows Gestionnaire de package.

Par défaut, le script installe la dernière version long term support (LTS) version, qui est .NET 10. Vous pouvez choisir une version spécifique en spécifiant le commutateur . Incluez le commutateur pour installer un runtime. Sinon, le script installe le SDK. Le script est disponible sur https://dot.net/v1/dotnet-install.ps1 et le code source est hébergé sur GitHub.

Télécharger le script

Pour plus d'informations sur le script, consultez - référence du script d'installation.

Installer le runtime

Le runtime .NET est installé en fournissant le commutateur -Runtime.

  1. Téléchargez le script depuis

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

  3. Exécutez les commandes suivantes pour installer à la fois le runtime desktop et ASP.NET Core runtime pour une compatibilité maximale :

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

Pour savoir comment utiliser l’interface CLI .NET, consultez .NET vue d’ensemble de l’interface CLI.

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

  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 .

Pour savoir comment utiliser l’interface CLI .NET, consultez .NET vue d’ensemble de l’interface CLI.

Vérification

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.

La page de téléchargement .NET avec checksum

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 affiche la somme de contrôle du fichier -sdk-9.0.306-win-x64.exe :

> certutil -hashfile dotnet-sdk-9.0.306-win-x64.exe SHA512
SHA512 hash of dotnet-sdk-9.0.306-win-x64.exe:
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f
CertUtil: -hashfile command completed successfully.

> (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f

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 .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 de .NET :

  1. La page notes de publication de .NET 9 sur GitHub à https://github.com/dotnet/core/tree/main/release-notes/9.0 contient une section nommée Releases. Le tableau de cette section fournit des liens vers les fichiers de téléchargement et de somme de contrôle pour chaque version de .NET 9. L’image suivante montre la table de mise en production .NET 8 comme référence :

    Le tableau de version des notes de publication github pour .NET

  2. Sélectionnez le lien pour la version de .NET que vous avez téléchargée. La section précédente a utilisé .NET SDK 9.0.306, qui se trouve dans la version .NET 9.0.10.

    Conseil

    Si vous ne savez pas quelle version .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 de .NET Runtime et de .NET SDK, ainsi qu'un lien vers le fichier de somme de contrôle. L’image suivante montre la table de mise en production .NET 8 comme référence :

    La table de téléchargement avec des sommes de contrôle pour .NET

  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://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt -OutFile 9.0.10-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 .\9.0.10-sha.txt | Select-String "dotnet-sdk-9.0.306-win-x64.exe").Line -like (Get-FileHash .\dotnet-sdk-9.0.306-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 risquez de rencontrer des problèmes lors de l’exécution de .NET commandes CLI. Cette section collecte ces problèmes courants et fournit des solutions.

Aucun sdk .NET n’a été trouvé

Vous avez probablement installé les versions x86 (32 bits) et x64 (64 bits) du SDK .NET. Cela provoque un conflit, car lorsque vous exécutez la commande , 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 pour résoudre d’abord en version x64.

  1. Vérifiez que les deux versions sont installées en exécutant la commande . Si vous le faites, vous devriez voir une entrée pour les dossiers \ et (x86)\. Si le dossier (x86)\ vient en premier, comme le montre l'exemple suivant, cela est incorrect et vous devez passer à l'étape suivante.

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

    Conseil

    Même si est utilisé dans cet exemple, vous pouvez voir d’autres copies de .exe répertoriées. Ajustez-les de manière à ce que le fichier .exe approprié soit résolu en premier.

    S'il est correct et Program Files\ est en premier, vous n'avez pas le problème dont parle cette section et vous devez 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 recherche. Sélectionnez Modifier les variables d’environnement système.

    Menu Démarrer de Windows avec modification de variable d’environnement

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

    Le panneau des propriétés système Windows s'ouvre.

  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.

    Fenêtre des variables d’environnement avec des variables utilisateur et système.

  5. Utilisez les boutons Déplacer vers le haut et Déplacer vers le bas pour déplacer l’entrée C :\\\ ci-dessus C :\ (x86)\\.

    Liste des variables d’environnement pour le système.

La création d’applications est plus lente que prévu

Assurez-vous 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).

est manquant

Installez Microsoft Visual C++ 2015-2019 Redistribuable (64 bits ou 32 bits).

Contenu connexe

  • Last updated on