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.

Version 5.0 ist die aktuelle Version von .NET.

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 Core 2.1 .NET Core 3.1 .NET 5
Windows 10 / Windows Server, Version 20H2 ✔️ ✔️ ✔️
Windows 10 / Windows Server, Version 2004 ✔️ ✔️ ✔️
Windows 10 / Windows Server, Version 1909 ✔️ ✔️ ✔️
Windows 10 / Windows Server, Version 1903 ✔️ ✔️ ✔️
Windows 10, Version 1809 ✔️ ✔️ ✔️
Windows 10, Version 1803 ✔️ ✔️ ✔️
Windows 10, Version 1709 ✔️ ✔️ ✔️
Windows 10, Version 1607 ✔️ ✔️ ✔️
Windows 8.1 ✔️ ✔️ ✔️
Windows 7 SP1 ESU ✔️ ✔️ ✔️
Windows Server 2019
Windows Server 2016
Windows Server 2012 R2
✔️ ✔️ ✔️
Windows Server Core 2012 R2 ✔️ ✔️ ✔️
Nano Server, Version 1809+ ✔️ ✔️ ✔️
Nano Server, Version 1803 ✔️ ✔️

Nicht unterstützte Versionen

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

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

Abhängigkeiten

Die folgenden Windows-Versionen werden von .NET 5.0 unterstützt:

Hinweis

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

Betriebssystem Version Architekturen
Windows 10-Client Version 1607 oder höher x64, x86, ARM64
Windows-Client 7 SP1 oder höher, 8.1 x64, x86
Windows Server 2012 R2 oder höher x64, x86
Windows Server Core 2012 R2 oder höher x64, x86
Nano Server Version 1809 und höher x64

Weitere Informationen zu den von .NET 5.0 unterstützten Betriebssystemen, Distributionen und Lebenszyklusrichtlinien finden Sie unter Von .NET 5.0 unterstützte 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 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

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 neueste Langzeitunterstützungsversion, nämlich .NET Core 3.1. 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.

dotnet-install.ps1 -Channel 5.0 -Runtime aspnetcore

Installieren Sie das SDK, und lassen Sie dabei den Parameter -Runtime weg. Der Parameter -Channel wird in diesem Beispiel auf Current festgelegt, wodurch die neuste unterstützte Version installiert wird.

dotnet-install.ps1 -Channel Current

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
5.0 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 und Cloud
  • Azure-Entwicklungsworkload im Abschnitt Web und Cloud
  • .NET-Desktopentwicklungsworkload im Abschnitt Desktop und mobil

Windows Visual Studio 2019 mit .NET Core-Workload

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 Core SDK herunter, und installieren Sie es.
  3. Installieren Sie die C#-Erweiterung aus dem Visual Studio Code Marketplace.

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

Herunterladen und manuelles Installieren

Alternativ zu den Windows-Installationsprogrammen für .NET können Sie das SDK oder die Runtime herunterladen und manuell installieren. Die manuelle Installation wird normalerweise im Rahmen von CI-Tests (Continuous Integration) durchgeführt. Für Entwickler oder Benutzer eignet sich in der Regel die Verwendung eines Installationsprogramms besser.

Sowohl das .NET SDK als auch die .NET-Runtime können nach dem Herunterladen manuell installiert werden. Wenn Sie das .NET SDK installieren, müssen Sie die entsprechende Runtime nicht installieren. Laden Sie zunächst eine binäre Version entweder für das SDK oder die Runtime von einer der folgenden Websites herunter:

Erstellen Sie ein Verzeichnis, in das .NET extrahiert werden soll, z. B. %USERPROFILE%\dotnet. Extrahieren Sie anschließend die heruntergeladene ZIP-Datei in dieses Verzeichnis.

Standardmäßig nutzen die Befehle und Anwendungen der .NET-CLI auf diese Weise installierte .NET-Instanzen nicht. Sie müssen sich explizit dafür entscheiden, .NET zu nutzen. Ändern Sie hierzu die Umgebungsvariablen, mit denen eine Anwendung gestartet wird:

set DOTNET_ROOT=%USERPROFILE%\dotnet
set PATH=%USERPROFILE%\dotnet;%PATH%
set DOTNET_MULTILEVEL_LOOKUP=0

Bei diesem Ansatz können Sie mehrere Versionen in separaten Speicherorten installieren und dann explizit auswählen, welcher Installationsspeicherort von einer Anwendung verwendet werden soll, indem die Anwendung mit Umgebungsvariablen ausgeführt wird, die auf diesen Speicherort zeigen.

Wenn DOTNET_MULTILEVEL_LOOKUP auf 0 festgelegt ist, ignoriert .NET alle global installierten .NET-Versionen. Entfernen Sie diese Umgebungseinstellung, damit .NET den globalen Standartinstallationsspeicherort bei der Auswahl des besten Frameworks zum Ausführen der Anwendung berücksichtigt. Das Standardverzeichnis ist in der Regel C:\Program Files\dotnet. Dort wird .NET von den Installationsprogrammen installiert.

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.

Nächste Schritte