Installieren von .NET Core unter WindowsInstall .NET Core on Windows

In diesem Artikel wird erläutert, wie Sie .NET Core unter Windows installieren.In this article, you'll learn how to install .NET Core on Windows. .NET Core besteht aus der Runtime und dem SDK..NET Core is made up of the runtime and the SDK. Die Runtime wird zum Ausführen von .NET Core-Apps verwendet und ist möglicherweise bereits in der App enthalten. Dies ist allerdings keine Voraussetzung.The runtime is used to run a .NET Core app and may or may not be included with the app. Das SDK wird zum Erstellen von .NET Core-Apps und -Bibliotheken verwendet.The SDK is used to create .NET Core apps and libraries. Die .NET Core-Runtime wird immer mit dem SDK installiert.The .NET Core runtime is always installed with the SDK.

Version 3.1 ist die aktuelle Version von .NET Core.The latest version of .NET Core is 3.1.

Unterstützte VersionenSupported releases

Die folgende Tabelle enthält die derzeit unterstützten .NET Core-Releases und die Windows-Versionen, die diese unterstützen.The following table is a list of currently supported .NET Core releases and the versions of Windows they're supported on. Diese Versionen werden so lange unterstützt, bis entweder die Version von .NET Core das Ende des Supports oder die Version von Windows das Ende ihrer Lebensdauer erreicht.These versions remain supported until either the version of .NET Core reaches end-of-support or the version of Windows reaches end-of-life.

Die Enddaten für den Support der einzelnen Windows 10-Versionen sind nach Editionen unterteilt.Windows 10 versions end-of-service dates are segmented by edition. In der folgenden Tabelle werden nur die Editionen Home, Pro, Pro Education und Pro for Workstations berücksichtigt.Only Home, Pro, Pro Education, and Pro for Workstations editions are considered in the following table. Weitere Details finden Sie im Informationsblatt zum Lebenszyklus von Windows.Check the Windows lifecycle fact sheet for specific details.

  • ✔️ gibt an, dass die Version von Windows oder .NET Core weiterhin unterstützt wird.A ✔️ indicates that the version of Windows or .NET Core is still supported.
  • ❌ gibt an, dass die Version von Windows oder .NET Core in dieser Windows-Version nicht unterstützt wird.A ❌ indicates that the version of Windows or .NET Core isn't supported on that Windows release.
  • Wenn sowohl für eine Version von Windows als auch für eine Version von .NET Core ein Häkchen (✔️) angegeben ist, wird diese Kombination aus Betriebssystem und .NET unterstützt.When both a version of Windows and a version of .NET Core have ✔️, that OS and .NET combination are supported.
BetriebssystemOperating System .NET Core 2.1.NET Core 2.1 .NET Core 3.1.NET Core 3.1 .NET 5 Preview.NET 5 Preview
✔️ Windows 10, Version 2004✔️ Windows 10, Version 2004 ✔️ 2.1✔️ 2.1 ✔️ 3.1✔️ 3.1 ✔️ 5.0 Preview✔️ 5.0 Preview
✔️ Windows 10, Version 1909✔️ Windows 10, Version 1909 ✔️ 2.1✔️ 2.1 ✔️ 3.1✔️ 3.1 ✔️ 5.0 Preview✔️ 5.0 Preview
✔️ Windows 10, Version 1903✔️ Windows 10, Version 1903 ✔️ 2.1✔️ 2.1 ✔️ 3.1✔️ 3.1 ✔️ 5.0 Preview✔️ 5.0 Preview
✔️ Windows 10, Version 1809✔️ Windows 10, Version 1809 ✔️ 2.1✔️ 2.1 ✔️ 3.1✔️ 3.1 ✔️ 5.0 Preview✔️ 5.0 Preview
❌ Windows 10, Version 1803❌ Windows 10, Version 1803 ✔️ 2.1✔️ 2.1 ❌ 3.1❌ 3.1 ❌ 5.0 Preview❌ 5.0 Preview
❌ Windows 10, Version 1709❌ Windows 10, Version 1709 ❌ 2.1❌ 2.1 ❌ 3.1❌ 3.1 ❌ 5.0 Preview❌ 5.0 Preview
❌ Windows 10, Version 1703❌ Windows 10, Version 1703 ❌ 2.1❌ 2.1 ❌ 3.1❌ 3.1 ❌ 5.0 Preview❌ 5.0 Preview
❌ Windows 10, Version 1607❌ Windows 10, Version 1607 ❌ 2.1❌ 2.1 ❌ 3.1❌ 3.1 ❌ 5.0 Preview❌ 5.0 Preview
❌ Windows 10, Version 1511❌ Windows 10, Version 1511 ❌ 2.1❌ 2.1 ❌ 3.1❌ 3.1 ❌ 5.0 Preview❌ 5.0 Preview
❌ Windows 10, Version 1507❌ Windows 10, Version 1507 ❌ 2.1❌ 2.1 ❌ 3.1❌ 3.1 ❌ 5.0 Preview❌ 5.0 Preview

Nicht unterstützte VersionenUnsupported releases

Die folgenden Versionen von .NET Core werden ❌ nicht mehr unterstützt.The following versions of .NET Core are ❌ no longer supported. Die Downloads dafür bleiben weiterhin veröffentlicht:The downloads for these still remain published:

  • 3.03.0
  • 2.22.2
  • 2.02.0

Informationen zur RuntimeRuntime information

Die Runtime wird zur Ausführung der mit .NET Core erstellten Apps verwendet.The runtime is used to run apps created with .NET Core. Wenn ein App-Autor eine App veröffentlicht, kann er die Runtime zusammen mit seiner App bereitstellen.When an app author publishes an app, they can include the runtime with their app. Wenn er die Runtime nicht hinzufügt, ist es dem Benutzer überlassen, die Runtime zu installieren.If they don't include the runtime, it's up to the user to install the runtime.

Es gibt drei verschiedene Runtimes, die Sie unter Windows installieren können:There are three different runtimes you can install on Windows:

ASP.NET Core-RuntimeASP.NET Core runtime
Diese führt ASP.NET Core-Apps aus.Runs ASP.NET Core apps. Sie umfasst die .NET Core-Runtime.Includes the .NET Core runtime.

DesktopruntimeDesktop runtime
Diese führt .NET Core-Desktop-Apps für Windows aus, die unter WPF oder Windows Forms erstellt wurden.Runs .NET Core WPF and .NET Core Windows Forms desktop apps for Windows. Sie umfasst die .NET Core-Runtime.Includes the .NET Core runtime.

.NET Core-Runtime.NET Core runtime
Hierbei handelt es sich um die einfachste Runtime, die keine weiteren Runtimes beinhaltet.This runtime is the simplest runtime and doesn't include any other runtime. 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 Core-Apps zu erzielen.It's highly recommended that you install both ASP.NET Core runtime and Desktop runtime for the best compatibility with .NET Core apps.

Informationen zum SDKSDK information

Das SDK wird zum Erstellen und Veröffentlichen von .NET Core-Apps und -Bibliotheken verwendet.The SDK is used to build and publish .NET Core apps and libraries. Die Installation des SDK umfasst alle drei Runtimes: ASP.NET Core, Desktop und .NET Core.Installing the SDK includes all three runtimes: ASP.NET Core, Desktop, and .NET Core.

AbhängigkeitenDependencies

Die folgenden Windows-Versionen werden von .NET Core 3.1 unterstützt:The following Windows versions are supported with .NET Core 3.1:

Hinweis

Die mindestens erforderliche Version ist mit einem +-Zeichen markiert.A + symbol represents the minimum version.

BetriebssystemOS VersionVersion ArchitekturenArchitectures
Windows-ClientWindows Client 8.18.1 x64, x86x64, x86
Windows 10-ClientWindows 10 Client Version 1609 und höherVersion 1609+ x64, x86x64, x86
Windows ServerWindows Server 2012 R2 oder höher2012 R2+ x64, x86x64, x86
Nano ServerNano Server Version 1803 oder höherVersion 1803+ x64, ARM32x64, ARM32

Weitere Informationen zu den von .NET Core 3.1 unterstützten Betriebssystemen, Verteilungen und Lebenszyklusrichtlinien finden Sie unter Von .NET Core 3.1 unterstützte Betriebssystemversionen.For more information about .NET Core 3.1 supported operating systems, distributions, and lifecycle policy, see .NET Core 3.1 Supported OS Versions.

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

Weitere Abhängigkeiten sind erforderlich, wenn Sie das .NET SDK oder die Runtime unter den folgenden Windows-Versionen installieren:Additional dependencies are required if you're installing the .NET SDK or runtime on the following Windows versions:

  • ❌ Windows 7 SP1❌ Windows 7 SP1
  • ❌ Windows Vista SP 2❌ Windows Vista SP 2
  • ✔️ Windows 8.1✔️ Windows 8.1
  • ✔️ Windows Server 2008 R2✔️ Windows Server 2008 R2
  • ✔️ Windows Server 2012 R2✔️ Windows Server 2012 R2

Installieren Sie Folgendes:Install the following:

Die oben aufgeführten Anforderungen sind auch erforderlich, wenn einer der folgenden Fehler auftritt:The requirements above are also required if you come across one of the following errors:

Das Programm kann nicht gestartet werden, da api-ms-win-crt-runtime-l1-1-0.dll auf dem Computer fehlt.The program can't start because api-ms-win-crt-runtime-l1-1-0.dll is missing from your computer. Installieren Sie das Programm erneut, um das Problem zu beheben.Try reinstalling the program to fix this problem.

- oder -- or -

Das Programm kann nicht gestartet werden, da api-ms-win-cor-timezone-l1-1-0.dll auf dem Computer fehlt.The program can't start because api-ms-win-cor-timezone-l1-1-0.dll is missing from your computer. Installieren Sie das Programm erneut, um das Problem zu beheben.Try reinstalling the program to fix this problem.

- oder -- or -

The library hostfxr.dll was found, but loading it from C:\<path_to_app>\hostfxr.dll failed. (Die Bibliothek „hostfxr.dll“ wurde gefunden, aber der Ladevorgang aus C:<Pfad_zu_App>\hostfxr.dll ist fehlgeschlagen.)The library hostfxr.dll was found, but loading it from C:\<path_to_app>\hostfxr.dll failed.

Installieren mit PowerShell-AutomatisierungInstall with PowerShell automation

Die dotnet-install-Skripts werden für die CI-Automatisierung und Installationen der Runtime durch Benutzer ohne Administratorrechte verwendet.The dotnet-install scripts are used for CI automation and non-admin installs of the runtime. Sie können das Skript über die Seite dotnet-install-Skriptverweis herunterladen.You can download the script from the dotnet-install script reference page.

Das Skript installiert standardmäßig die neueste Langzeitunterstützungsversion, nämlich .NET Core 3.1.The script defaults to installing the latest long term support (LTS) version, which is .NET Core 3.1. Sie können eine bestimmte Version durch Angeben der Channel-Option auswählen.You can choose a specific release by specifying the Channel switch. Schließen Sie die Runtime-Option mit ein, um eine Runtime zu installieren.Include the Runtime switch to install a runtime. Andernfalls installiert das Skript das SDK nicht.Otherwise, the script installs the SDK.

dotnet-install.ps1 -Channel 3.1 -Runtime aspnetcore

Installieren Sie das SDK, und lassen Sie dabei den Parameter -Runtime weg.Install the SDK by omitting the -Runtime switch. Der Parameter -Channel wird in diesem Beispiel auf Current festgelegt, wodurch die neuste unterstützte Version installiert wird.The -Channel switch is set in this example to Current, which installs the latest supported version.

dotnet-install.ps1 -Channel Current

Installieren mit Visual StudioInstall with Visual Studio

Für den Fall, dass Sie Visual Studio zum Entwickeln von .NET Core-Apps verwenden, finden Sie in der folgenden Tabelle basierend auf der .NET Core SDK-Zielversion die mindestens erforderliche Version von Visual Studio.If you're using Visual Studio to develop .NET Core apps, the following table describes the minimum required version of Visual Studio based on the target .NET Core SDK version.

.NET Core SDK-Version.NET Core SDK version Visual Studio-VersionVisual Studio version
3.13.1 Visual Studio 2019 Version 16.4 oder höherVisual Studio 2019 version 16.4 or higher.
3.03.0 Visual Studio 2019 Version 16.3 oder höherVisual Studio 2019 version 16.3 or higher.
2.22.2 Visual Studio 2017 Version 15.9 oder höherVisual Studio 2017 version 15.9 or higher.
2.12.1 Visual Studio 2017 Version 15.7 oder höherVisual Studio 2017 version 15.7 or higher.

Wenn Sie Visual Studio bereits installiert haben, können Sie Ihre Version mit den folgenden Schritten überprüfen.If you already have Visual Studio installed, you can check your version with the following steps.

  1. Öffnen Sie Visual Studio.Open Visual Studio.
  2. Klicken Sie auf Hilfe > Info.Select Help > About Microsoft Visual Studio.
  3. Informieren Sie sich über die Versionsnummer im Dialogfeld Info.Read the version number from the About dialog.

Visual Studio kann das neueste .NET Core SDK und die Runtime installieren.Visual Studio can install the latest .NET Core SDK and runtime.

Workload auswählenSelect a workload

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:When installing or modifying Visual Studio, select one or more of the following workloads, depending on the kind of application you're building:

  • Die Workload Plattformübergreifende .NET Core-Entwicklung im Abschnitt Weitere ToolsetsThe .NET Core cross-platform development workload in the Other Toolsets section.
  • Die Workload ASP.NET und Webentwicklung im Abschnitt Web und CloudThe ASP.NET and web development workload in the Web & Cloud section.
  • Azure-Entwicklungsworkload im Abschnitt Web und CloudThe Azure development workload in the Web & Cloud section.
  • .NET-Desktopentwicklungsworkload im Abschnitt Desktop und mobilThe .NET desktop development workload in the Desktop & Mobile section.

Windows Visual Studio 2019 mit .NET Core-WorkloadWindows Visual Studio 2019 with .NET Core workload

Installieren zusammen mit Visual Studio CodeInstall alongside Visual Studio Code

Visual Studio Code ist ein leistungsstarker und einfacher Quellcode-Editor, der auf Ihrem Desktop ausgeführt wird.Visual Studio Code is a powerful and lightweight source code editor that runs on your desktop. Visual Studio Code ist für Windows, macOS und Linux verfügbar.Visual Studio Code is available for Windows, macOS, and Linux.

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.While Visual Studio Code doesn't come with an automated .NET Core installer like Visual Studio does, adding .NET Core support is simple.

  1. Laden Sie Visual Studio Code herunter, und installieren Sie das Tool.Download and install Visual Studio Code.
  2. Laden Sie das .NET Core SDK herunter, und installieren Sie es.Download and install the .NET Core SDK.
  3. Installieren Sie die C#-Erweiterung aus dem Visual Studio Code Marketplace.Install the C# extension from the Visual Studio Code marketplace.

Herunterladen und manuelles InstallierenDownload and manually install

Alternativ zu den Windows-Installationsprogrammen für .NET Core können Sie das SDK oder die Runtime herunterladen und manuell installieren.As an alternative to the Windows installers for .NET Core, you can download and manually install the SDK or runtime. Die manuelle Installation wird normalerweise im Rahmen von CI-Tests (Continuous Integration) durchgeführt.Manual install is usually performed as part of continuous integration testing. Für Entwickler oder Benutzer eignet sich in der Regel die Verwendung eines Installationsprogramms besser.For a developer or user, it's generally better to use an installer.

Sowohl das .NET Core SDK als auch die .NET Core-Runtime können nach dem Herunterladen manuell installiert werden.Both .NET Core SDK and .NET Core Runtime can be manually installed after they've been downloaded. Wenn Sie das .NET Core SDK installieren, müssen Sie die entsprechende Runtime nicht installieren.If you install .NET Core SDK, you don't need to install the corresponding runtime. Laden Sie zunächst eine binäre Version entweder für das SDK oder die Runtime von einer der folgenden Websites herunter:First, download a binary release for either the SDK or the runtime from one of the following sites:

Erstellen Sie ein Verzeichnis, in das .NET extrahiert werden soll, z. B. %USERPROFILE%\dotnet.Create a directory to extract .NET to, for example %USERPROFILE%\dotnet. Extrahieren Sie anschließend die heruntergeladene ZIP-Datei in dieses Verzeichnis.Then, extract the downloaded zip file into that directory.

Standardmäßig nutzen die Befehle und Anwendungen der .NET Core CLI auf diese Weise installiertes .NET Core nicht. Sie müssen sich explizit dafür entscheiden, es zu nutzen.By default, .NET Core CLI commands and apps won't use .NET Core installed in this way and you must explicitly choose to use it. Ändern Sie hierzu die Umgebungsvariablen, mit denen eine Anwendung gestartet wird:To do so, change the environment variables with which an application is started:

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.This approach lets you install multiple versions into separate locations, then explicitly choose which install location an application should use by running the application with environment variables pointing at that location.

Wenn DOTNET_MULTILEVEL_LOOKUP auf 0 festgelegt ist, ignoriert .NET Core alle global installierten .NET Core-Versionen.When DOTNET_MULTILEVEL_LOOKUP is set to 0, .NET Core ignores any globally installed .NET Core version. Entfernen Sie diese Umgebungseinstellung, damit .NET Core den globalen Standartinstallationsort bei der Auswahl des besten Frameworks zum Ausführen der Anwendung berücksichtigt.Remove that environment setting to let .NET Core consider the default global install location when selecting the best framework for running the application. Das Standardverzeichnis ist in der Regel C:\Program Files\dotnet. Dort wird .NET Core von den Installationsprogrammen installiert.The default is typically C:\Program Files\dotnet, which is where the installers install .NET Core.

DockerDocker

Container bieten eine einfache Möglichkeit, Ihre Anwendung vom Rest des Hostsystems zu isolieren.Containers provide a lightweight way to isolate your application from the rest of the host system. Container auf demselben Computer teilen nur den Kernel und verwenden die Ihrer Anwendung zur Verfügung gestellten Ressourcen.Containers on the same machine share just the kernel and use resources given to your application.

.NET Core kann in einem Docker-Container ausgeführt werden..NET Core can run in a Docker container. Offizielle.NET Core Docker-Images werden in Microsoft Container Registry (MCR) veröffentlicht und sind im Microsoft.NET Core Docker-Hub-Repository verfügbar.Official .NET Core Docker images are published to the Microsoft Container Registry (MCR) and are discoverable at the Microsoft .NET Core Docker Hub repository. Jedes Repository enthält Images für verschiedene Kombinationen von .NET (SDK oder Runtime) und dem Betriebssystem, die Sie verwenden können.Each repository contains images for different combinations of the .NET (SDK or Runtime) and OS that you can use.

Microsoft stellt Images bereit, die auf bestimmte Szenarien zugeschnitten sind.Microsoft provides images that are tailored for specific scenarios. 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.For example, the ASP.NET Core repository provides images that are built for running ASP.NET Core apps in production.

Weitere Informationen zur Verwendung von .NET Core in einem Docker-Container finden Sie unter Einführung in .NET und Docker und Beispiele.For more information about using .NET Core in a Docker container, see Introduction to .NET and Docker and Samples.

Nächste SchritteNext steps