Installieren von .NET unter Windows

In diesem Artikel wird erläutert, wie Sie .NET unter Windows installieren. .NET besteht aus der Runtime und dem SDK. Die Runtime wird zum Ausführen von .NET-Apps verwendet und ist möglicherweise bereits in der App enthalten. Das SDK wird zum Erstellen von .NET-Apps und -Bibliotheken verwendet. Die .NET-Runtime wird immer mit dem SDK installiert.

Die neueste Version von .NET ist 7.

Es gibt zwei Arten von unterstützten Releases: LtS-Releases (Long Term Support) oder Standard Term Support (STS). Die Qualität aller Releases ist gleich. Der einzige Unterschied ist die Länge der Unterstützung. LTS-Releases erhalten kostenlosen Support und Patches für 3 Jahre. STS-Releases erhalten 18 Monate lang kostenlosen Support und Patches. Weitere Informationen finden Sie unter .NET-Supportrichtlinie.

In der folgenden Tabelle ist der Supportstatus der einzelnen Versionen von .NET (und .NET Core) aufgeführt:

✔️ Unterstützt ❌ Nicht unterstützt
7 (STS) 5
6 (LTS) 3.0
3.1 (LTS) 2.2
2.1
2.0
1.1
1.0

Installieren mit Windows-Paket-Manager (winget)

Sie können .NET mithilfe des winget-Tools über den Windows-Paket-Manager-Dienst installieren und verwalten. Weitere Informationen zum Installieren und Verwenden von winget finden Sie unter Verwenden des Winget-Tools.

Wenn Sie .NET systemweit installieren, installieren Sie die Installation mit Administratorrechten.

Installieren des SDKs

Das .NET SDK ermöglicht Ihnen die Entwicklung von Apps mit .NET. Wenn Sie das .NET SDK installieren, müssen Sie die entsprechenden Runtimes nicht installieren. Führen Sie den folgenden Befehl aus, um das .NET SDK zu installieren:

winget install Microsoft.DotNet.SDK.7

Installieren der Runtime

Für Windows gibt es drei .NET-Runtimes, die Sie installieren können. Sie sollten sowohl die .NET Desktop Runtime als auch die ASP.NET Core Runtime installieren, um sicherzustellen, dass Sie mit allen Typen von .NET-Apps kompatibel sind.

  • .NET Desktop Runtime

    Diese Runtime umfasst die .NET-Basislaufzeit und unterstützt Windows Presentation Foundation (WPF) und Windows Forms Apps, die mit .NET erstellt werden. Dies ist nicht dasselbe wie .NET Framework, das in Windows enthalten ist.

    winget install Microsoft.DotNet.DesktopRuntime.7
    
  • ASP.NET Core Runtime

    Diese Runtime umfasst die .NET-Basislaufzeit und führt Webserver-Apps aus. Die ASP.NET Core-Runtime ermöglicht Ihnen die Ausführung von Apps, die mit .NET erstellt wurden und die Runtime nicht enthalten. Durch die folgenden Befehle wird die ASP.NET Core-Runtime installiert, d. h. die Runtime für .NET mit der höchsten Kompatibilität. Führen Sie in Ihrem Terminal die folgenden Befehle aus:

    winget install Microsoft.DotNet.AspNetCore.7
    
  • .Net-Runtime

    Dies ist die Basislaufzeit und enthält nur die Komponenten, die zum Ausführen einer Konsolen-App erforderlich sind. In der Regel installieren Sie die anderen Runtimes.

    winget install Microsoft.DotNet.Runtime.7
    

Sie können Vorschauversionen der Runtimes installieren, indem Sie die Versionsnummer, z 6. B. , durch das Wort Previewersetzen. Im folgenden Beispiel wird die Vorschauversion der .NET Desktop Runtime installiert:

winget install Microsoft.DotNet.DesktopRuntime.Preview

Installieren zusammen mit Visual Studio Code

Visual Studio Code ist ein leistungsstarker und einfacher Quellcode-Editor, der auf Ihrem Desktop ausgeführt wird. Visual Studio Code ist für Windows, macOS und Linux verfügbar.

Zwar verfügt Visual Studio Code im Gegensatz zu Visual Studio über keine automatisierten .NET Core-Installer, allerdings ist das Hinzufügen der Unterstützung von .NET Core einfach.

  1. Laden Sie Visual Studio Code herunter, und installieren Sie das Tool.
  2. Laden Sie das .NET SDK herunter, und installieren Sie es.
  3. Installieren Sie die C#-Erweiterung aus dem Visual Studio Code Marketplace.

Installieren mit Windows Installer

Die Downloadseite für .NET bietet ausführbare Windows Installer-Dateien.

Wenn Sie den Windows Installer für die Installation von .NET verwenden, können Sie den Installationspfad durch Festlegung der Parameter DOTNETHOME_X64 und DOTNETHOME_X86 anpassen:

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

Wenn Sie .NET im Hintergrund installieren möchten (z. B. in einer Produktionsumgebung oder zur Unterstützung von Continuous Integration), sollten Sie die folgenden Optionen verwenden:

  • /install
    Installiert .NET

  • /quiet
    Verhindert, dass die Benutzeroberfläche und Eingabeaufforderungen angezeigt werden

  • /norestart
    Unterdrückt alle Neustartversuche.

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

Weitere Informationen finden Sie unter Standardbefehlszeilenoptionen für Installer.

Tipp

Der Installer gibt bei Erfolg den Exitcode 0 zurück. Wenn ein Neustart erforderlich ist, wird der Exitcode 3010 zurückgegeben. Bei allen anderen Werten handelt es sich um Fehlercodes.

Installieren mit PowerShell-Automatisierung

Die dotnet-install-Skripts werden für die CI-Automatisierung und Installationen der Runtime durch Benutzer ohne Administratorrechte verwendet. Sie können das Skript über die Seite dotnet-install-Skriptverweis herunterladen.

Das Skript installiert standardmäßig die aktuelle Version von LTS (Long-Term Support), die derzeit .NET 6 entspricht. Sie können eine bestimmte Version durch Angeben der Channel-Option auswählen. Schließen Sie die Runtime-Option mit ein, um eine Runtime zu installieren. Andernfalls installiert das Skript das SDK nicht.

Mit dem folgenden Befehl wird die ASP.NET Core Runtime installiert, um maximale Kompatibilität zu erhalten. Die ASP.NET Core-Runtime enthält auch die .NET-Standardruntime.

dotnet-install.ps1 -Channel 7.0 -Runtime aspnetcore

Installieren Sie das SDK, und lassen Sie dabei den Parameter -Runtime weg. Der -Channel Schalter ist in diesem Beispiel auf STSfestgelegt, wodurch die neueste Version des Support für Standardlaufzeiten (.NET 7) installiert wird.

dotnet-install.ps1 -Channel STS

Installieren mit Visual Studio

Für den Fall, dass Sie Visual Studio zum Entwickeln von .NET-Apps verwenden, finden Sie in der folgenden Tabelle basierend auf der .NET SDK-Zielversion die mindestens erforderliche Version von Visual Studio.

.NET SDK-Version Visual Studio-Version
7 Visual Studio 2022, Version 17.4 oder höher.
6 Visual Studio 2022 Version 17.0 oder höher.
5 Visual Studio 2019 Version 16.8 oder höher
3.1 Visual Studio 2019 Version 16.4 oder höher
3.0 Visual Studio 2019 Version 16.3 oder höher
2.2 Visual Studio 2017 Version 15.9 oder höher
2.1 Visual Studio 2017 Version 15.7 oder höher

Wenn Sie Visual Studio bereits installiert haben, können Sie Ihre Version mit den folgenden Schritten überprüfen.

  1. Öffnen Sie Visual Studio.
  2. Klicken Sie auf Hilfe>Info.
  3. Informieren Sie sich über die Versionsnummer im Dialogfeld Info.

Visual Studio kann das neueste .NET SDK und die Runtime installieren.

Workload auswählen

Wählen Sie in Abhängigkeit vom Typ der von Ihnen erstellten Anwendung beim Installieren oder Ändern von Visual Studio mindestens eine der folgenden Workloads aus:

  • Die Workload Plattformübergreifende .NET Core-Entwicklung im Abschnitt Weitere Toolsets
  • Die Workload ASP.NET und Webentwicklung im Abschnitt Web & Cloud .
  • Die Azure-Entwicklungsworkload im Abschnitt Web & Cloud .
  • Die Workload für die .NET-Desktopentwicklung im Abschnitt Desktop & Mobile .

Windows Visual Studio 2019 mit .NET Core-Workload

Unterstützte Versionen

Die folgende Tabelle enthält die derzeit unterstützten .NET-Releases und die Windows-Versionen, die diese unterstützen. Diese Versionen werden so lange unterstützt, bis entweder die Version von .NET das Ende des Supports oder die Version von Windows das Ende ihrer Lebensdauer erreicht.

Die Enddaten für den Support der einzelnen Windows 10-Versionen sind nach Editionen unterteilt. In der folgenden Tabelle werden nur die Editionen Home, Pro, Pro Education und Pro for Workstations berücksichtigt. Weitere Details finden Sie im Informationsblatt zum Lebenszyklus von Windows.

Tipp

Die mindestens erforderliche Version ist mit einem +-Zeichen markiert.

Betriebssystem .NET 7 .NET 6 .NET Core 3.1
Windows 11 ✔️ ✔️ ✔️
Windows Server 2022 ✔️ ✔️ ✔️
Windows Server, Version 1903 oder höher ✔️ ✔️ ✔️
Windows 10, Version 1607 oder höher ✔️ ✔️ ✔️
Windows 8.1 ✔️ ✔️
Windows 7 SP1 ESU ✔️ ✔️
Windows Server 2019
Windows Server 2016
Windows Server 2012 R2
Windows Server 2012
✔️ ✔️
Windows Server Core 2012 R2 ✔️ ✔️ ✔️
Windows Server Core 2012 ✔️ ✔️ ✔️
Nano Server, Version 1809+ ✔️ ✔️ ✔️
Nano Server, Version 1803 ✔️

Weitere Informationen zu von .NET 7 unterstützten Betriebssystemen, Distributionen und Lebenszyklusrichtlinien finden Sie unter Unterstützte .NET 7-Betriebssystemversionen.

Nicht unterstützte Versionen

Die folgenden Versionen von .NET ❌ werden nicht mehr unterstützt:

  • .NET 5
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

Informationen zur Runtime

Die Runtime wird zur Ausführung der mit .NET erstellten Apps verwendet. Wenn ein App-Autor eine App veröffentlicht, kann er die Runtime zusammen mit seiner App bereitstellen. Wenn er die Runtime nicht hinzufügt, ist es dem Benutzer überlassen, die Runtime zu installieren.

Es gibt drei verschiedene Runtimes, die Sie unter Windows installieren können:

  • ASP.NET Core-Runtime
    Diese führt ASP.NET Core-Apps aus. Diese Runtime schließt die .NET-Runtime ein.

  • Desktopruntime
    Diese führt .NET-Desktop-Apps für Windows aus, die unter WPF oder Windows Forms erstellt wurden. Diese Runtime schließt die .NET-Runtime ein.

  • .NET-Runtime
    Hierbei handelt es sich um die einfachste Runtime, die keine weiteren Runtimes beinhaltet. Es wird dringend empfohlen, dass Sie sowohl die ASP.NET Core-Runtime als auch die Desktop-Runtime installieren, um die bestmögliche Kompatibilität mit .NET-Apps zu erzielen.

Informationen zum SDK

Das SDK wird zum Erstellen und Veröffentlichen von .NET-Apps und -Bibliotheken verwendet. Die Installation des SDK umfasst alle drei Runtimes: ASP.NET Core, Desktop und .NET.

Arm-basierte Windows-PCs

In den folgenden Abschnitten werden die Punkte beschrieben, die Sie bei der Installation von .NET auf einem Arm-basierten Windows-PC berücksichtigen sollten.

Unterstützte Funktionen

In der folgenden Tabelle wird beschrieben, welche Versionen von .NET auf einem Arm-basierten Windows PC unterstützt werden:

.NET-Version Architektur SDK Typ Pfadkonflikt
7 ARM64 Ja Ja Nein
7 x64 Ja Ja Nein
6 ARM64 Ja Ja Nein
6 x64 Ja Ja Nein
5 ARM64 Ja Ja Ja
5 x64 Nein Ja Ja
3.1 ARM64 Nein Nein
3.1 x64 Nein Ja Ja

Ab .NET 6 sind die x64- und Arm64-Versionen des .NET SDK unabhängig voneinander vorhanden. Wenn eine neue Version veröffentlicht wird, muss jede Architekturinstallation aktualisiert werden.

Pfadunterschiede

Auf einem Arm-basierten Windows-PC werden alle Arm64-Versionen von .NET im normalen Ordner C:\Programme\dotnet\ installiert. Wenn Sie jedoch die x64-Version von .NET 6 SDK oder .NET 7 SDK installieren, wird sie im Ordner C:\Programme\dotnet\x64\ installiert.

Pfadkonflikte

Ab .NET 6 wird das x64 .NET SDK in einem eigenen Verzeichnis installiert, wie im vorherigen Abschnitt beschrieben. Dadurch können die Arm64- und x64-Versionen des .NET SDK auf demselben Computer vorhanden sein. Jedes x64 SDK vor 6 wird jedoch nicht unterstützt und installiert sich am selben Speicherort wie die Arm64-Version, dem Ordner C:\Programme\dotnet\ . Wenn Sie ein nicht unterstütztes x64-SDK installieren möchten, müssen Sie zuerst die Arm64-Version deinstallieren. Das Gegenteil ist ebenfalls zutreffend: Sie müssen das nicht unterstützte x64-SDK deinstallieren, um die Arm64-Version zu installieren.

Pfadvariablen

Umgebungsvariablen, die .NET zum Systempfad hinzufügen, z. B. die PATH Variable, müssen möglicherweise geändert werden, wenn Sie sowohl die x64- als auch die Arm64-Versionen des .NET SDK installiert haben. Darüber hinaus basieren einige Tools auf der Umgebungsvariablen DOTNET_ROOT , die ebenfalls aktualisiert werden muss, um auf den entsprechenden .NET SDK-Installationsordner zu verweisen.

Abhängigkeiten

Die folgenden Windows-Versionen werden mit .NET 7 unterstützt:

Hinweis

Die mindestens erforderliche Version ist mit einem +-Zeichen markiert.

Betriebssystem Version Architekturen
Windows 11 21H2+ x64, Arm64
Windows 10-Client 1607 und höher x64, x86, Arm64
Windows-Client 7 SP1 oder höher, 8.1 x64, x86
Windows Server 2012 oder höher x64, x86
Windows Server Core 2012 oder höher x64, x86
Nano Server 1809 und höher x64

Weitere Informationen zu von .NET 7 unterstützten Betriebssystemen, Distributionen und Lebenszyklusrichtlinien finden Sie unter Unterstützte .NET 7-Betriebssystemversionen.

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

Weitere Abhängigkeiten sind erforderlich, wenn Sie das .NET SDK oder die .NET-Runtime unter den folgenden Windows-Versionen installieren:

Betriebssystem Voraussetzungen
Windows 7 SP1 ESU – Microsoft Visual C++ 2015-2019 Redistributable 64-Bit / 32-Bit
– KB3063858 64-Bit / 32-Bit
- Microsoft Root Certificate Authority 2011 (nur das Offline-Installationsprogramm von .NET Core 2.1)
Windows Vista SP 2 Microsoft Visual C++ 2015-2019 Redistributable 64-Bit / 32-Bit
Windows 8.1 Microsoft Visual C++ 2015-2019 Redistributable 64-Bit / 32-Bit
Windows Server 2008 R2 Microsoft Visual C++ 2015-2019 Redistributable 64-Bit / 32-Bit
Windows Server 2012 Microsoft Visual C++ 2015-2019 Redistributable 64-Bit / 32-Bit
Windows Server 2012 R2 Microsoft Visual C++ 2015-2019 Redistributable 64-Bit / 32-Bit

Die vorherigen Anforderungen gelten auch, wenn ein Fehler im Zusammenhang mit einer der folgenden DLLs auftritt:

  • api-ms-win-crt-runtime-l1-1-0.dll
  • api-ms-win-cor-timezone-l1-1-0.dll
  • hostfxr.dll

Docker

Container bieten eine einfache Möglichkeit, Ihre Anwendung vom Rest des Hostsystems zu isolieren. Container auf demselben Computer teilen nur den Kernel und verwenden die Ihrer Anwendung zur Verfügung gestellten Ressourcen.

.NET kann in einem Docker-Container ausgeführt werden. Offizielle Docker-Images für .NET werden in Microsoft Container Registry (MCR) veröffentlicht und sind im Microsoft.NET Docker-Hub-Repository verfügbar. Jedes Repository enthält Images für verschiedene Kombinationen von .NET (SDK oder Runtime) und dem Betriebssystem, die Sie verwenden können.

Microsoft stellt Images bereit, die auf bestimmte Szenarien zugeschnitten sind. So stellt beispielsweise das ASP.NET Core-Repository Images bereit, die für die Ausführung von ASP.NET Core-Apps in der Produktion erstellt wurden.

Weitere Informationen zur Verwendung von .NET in einem Docker-Container finden Sie unter Einführung zu .NET und Docker und Docker-Beispiele für .NET.

Problembehandlung

Nach der Installation des .NET SDK können Probleme beim Ausführen von .NET CLI-Befehlen auftreten. In diesem Abschnitt werden diese häufigen Probleme gesammelt und Lösungen bereitgestellt.

Es war nicht möglich, installierte .NET Core-SDKs zu finden.

Wahrscheinlich haben Sie sowohl die x86-Version (32-Bit) als auch die x64-Version (64-Bit) des .NET SDK installiert. Dies verursacht einen Konflikt, da beim Ausführen des dotnet Befehls in die x86-Version aufgelöst wird, wenn er in die x64-Version aufgelöst werden soll. Dies wird in der Regel behoben, indem Sie die %PATH% Variable so anpassen, dass zuerst die x64-Version aufgelöst wird.

  1. Vergewissern Sie sich, dass beide Versionen installiert sind, indem Sie den where.exe dotnet Befehl ausführen. Wenn Sie dies tun, sollte ein Eintrag für die Ordner Programme\ und Programme (x86)\ angezeigt werden. Wenn sich der Ordner Programme (x86)\ wie im folgenden Beispiel angegeben zuerst befindet, ist er falsch, und Sie sollten mit dem nächsten Schritt fortfahren.

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

    Wenn dies richtig ist und die Programme an erster Stelle stehen, haben Sie nicht das Problem, das in diesem Abschnitt behandelt wird, und Sie sollten ein .NET-Hilfeanforderungsproblem auf GitHub erstellen.

  2. Drücken Sie die Windows-Schaltfläche, und geben Sie "Systemumgebungsvariablen bearbeiten" in search ein. Wählen Sie Systemumgebungsvariablen bearbeiten aus.

    Windows-Startmenü mit Umgebungsvariable bearbeiten

  3. Das Fenster Systemeigenschaften wird zur Registerkarte Erweitert geöffnet. Wählen Sie Umgebungsvariablen aus.

    Der Bereich Windows-Systemeigenschaften ist geöffnet.

  4. Wählen Sie im Fenster Umgebungsvariablen unter der Gruppe Systemvariablen die Zeile Pfad* und dann die Schaltfläche Bearbeiten aus.

    Das Fenster

  5. Verwenden Sie die Schaltflächen Nach oben und Nach unten , um den Eintrag C:\Programme\dotnet\ über C:\Programme (x86)\dotnet\ zu verschieben.

    Die Liste der Umgebungsvariablen für das System.

Nächste Schritte