Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Versionsverwaltung des .NET SDK und seine Beziehung zu Visual Studio und MSBuild kann schwer verständlich sein. MSBuild wird mit Visual Studio versioniert, ist aber auch im -NET SDK enthalten. Das SDK verfügt über eine Mindestversion von MSBuild und Visual Studio, mit der es funktioniert, und es wird nicht in einer Version von Visual Studio geladen, die älter als diese Mindestversion ist.
Versionskontrolle
Die .NET SDK-Versionsnummer verwendet das Format major.minor.patch, wobei:
-
major.minorentspricht der .NET-Version, die das SDK umfasst, auf der es standardmäßig ausgeführt wird und auf die es standardmäßig abzielt. - Die Hunderterstelle von
patchidentifiziert das Featureband, z. B.1xx,2xx,3xxoder4xx. Das Featureband beginnt bei 1 und erhöht sich für jede vierteljährliche .NET SDK-Version. - Die letzten beiden Ziffern von
patchsind Teil der Patchversion, die mit jedem Wartungsupdate des Monats erhöht wird.
Die Version 7.0.203 wird zusammen mit .NET 7 veröffentlicht, ist die zweite vierteljährliche Veröffentlichungsreihe seit dem Erscheinen von 7.0.100 und der dritte Patch seit der Veröffentlichung von 7.0.200.
Eine Installation von Visual Studio enthält eine einzige übereinstimmende Kopie des .NET SDK. Wenn Sie Ihre Visual Studio-Instanz aktualisieren, wird auch das von Visual Studio installierte .NET SDK aktualisiert, einschließlich aller .NET SDK-Funktionsbänder und Hauptbänder. Wenn Sie ein anderes .NET SDK verwenden möchten als das, was von Visual Studio installiert wird, können Sie es auf der .NET-Downloadseiteinstallieren, und das Visual Studio-Upgrade berührt diese Version nicht. Sie sind dafür verantwortlich, diese Kopie des .NET SDK anschließend zu aktualisieren.
Ab Visual Studio 18.0 werden monatliche Nebenversionen von Visual Studio ausgeliefert, während das .NET SDK weiterhin vierteljährlich ausgeliefert wird. Visual Studio-Versionen zwischen vierteljährlichen .NET SDK-Versionen enthalten nur Patchversionen des neuesten .NET SDK.
Hinweis
Das .NET SDK unterstützt die Ausrichtung auf niedrigere Versionen von .NET. Wir empfehlen daher, Ihr .NET SDK immer zusammen mit Ihrer Visual Studio-Version zu aktualisieren.
Lebenszyklus
Der Supportzeitrahmen für das SDK entspricht in der Regel der Visual Studio-Version, in dem es enthalten ist.
Erweitern, um nicht mehr unterstützte .NET-Versionen anzuzeigen
| SDK-Version | MSBuild-/Visual Studio-Version | Auslieferungsdatum | Lebenszyklus |
|---|---|---|---|
| 2.1.5xx | 15,9 | Nov. '18 | Aug. 21 |
| 2.1.8xx | 16.2 (kein VS) | Juli 19 | Aug. 21 |
| 3.1.1xx | 16.4 | Dez. 19 | Okt '21 |
| 3.1.4xx | 16.7 | Aug. 20 | Dez. 22 |
| 5.0.1xx | 16.8 | Nov. 2020 | Mär. 21 |
| 5.0.2xx | 16,9 | März '21 | Mai 2022 |
| 5.0.3xx | 16.10 | Mai 21 | Aug. 21 |
| 5.0.4xx | 16.11 | Aug. 21 | Mai 2022 |
| 6.0.1xx | 17.0 | Nov. 2021 | 24. November |
| 6.0.2xx | 17.1 | Feb. 2022 | Mai 2022 |
| 6.0.3xx | 17.23 | Mai 2022 | Okt. 2023 |
| 6.0.4xx | 17,3 | Aug. 22 | 24. November |
| 7.0.1xx | 17.4 | Nov. 2022 | Mai 2024 |
| 7.0.2xx | 17.53 | Feb. 2023 | Mai '23 |
| 7.0.3xx | 17.6 | Mai '23 | Mai 2024 |
| 7.0.4xx | 17,7 | Aug. 2023 | Mai 2024 |
Unterstützte .NET-Versionen
| SDK-Version | MSBuild-/Visual Studio-Version | Auslieferungsdatum | Lebenszyklus |
|---|---|---|---|
| 8.0.1xx | 17.8 | Nov. 23 | Nov. 20261 |
| 8.0.2xx | 17,9 | Feb. 24 | Mai 2024 |
| 8.0.3xx | 17.10 | Mai 2024 | 26. Januar |
| 8.0.4xx | 17,11 | Aug. 24 | Nov. 20262 |
| 9.0.1xx | 17.12 | 24. November | Mai '26 |
| 9.0.2xx | 17.13 | 25. Februar | 25. Mai |
| 9.0.3xx | 17.14 | 25. Mai | Nov. 20262 |
| 10.0.1xx | 18.0 | Nov. '25 | Nov. '28 |
| 10.0.2xx | 18.4 | 26. März | Mai '26 |
Hinweis
1 Die Featuregruppen des .1xx .NET SDK werden während des gesamten Lebenszyklus von .NET-Hauptversionen unterstützt. Während des erweiterten Supportzeitraums ist der Support auf Sicherheitsfixes und minimale nicht sicherheitsrelevante Fixes mit hoher Priorität, die nur für Linux verfügbar sind, beschränkt. Weitere Informationen zu den Gründen für diesen erweiterten Support finden Sie im Dokument zur Unterstützung des Quellbuilds.
2 Die endgültigen .NET SDK-Feature-Bänder einer Hauptversion werden während der gesamten Lebensdauer der passenden Laufzeit als eigenständige Installationen unterstützt.
Visual Studio 2026-Lebenszyklus
Zielfestlegung und Regeln für die Unterstützung
Die folgende Richtlinie bestimmt, in welchen Versionen von MSBuild und Visual Studio eine bestimmte Version des .NET SDK ausgeführt wird:
- Jedes neue TargetFramework erfordert eine neue Visual Studio-Version oder eine neue
dotnet-Version. - Die erste Version von Visual Studio, die ein neues TargetFramework unterstützt, wird die Mindestversion für die Featuregruppen dieses SDK beispielsweise für die Roslyn-API-Schnittstelle, MSBuild-Ziele, Quell-Generatoren und Analysetools.
- Die erste Version eines neuen .NET SDK, die ein neues TargetFramework unterstützt, kann auch mit der früheren Visual Studio-Version verwendet werden, um ein Viertel der Tools und Infrastruktur (z. B. Aktionen und Pipelines) zu migrieren.
| Softwareentwicklungskit (SDK) | Visual Studio-Version das SDK wird mitgeliefert |
Mindestversion von Visual Studio | TargetFramework-Höchstversion in Mindestversion von Visual Studio |
TargetFramework-Höchstversion in dotnet |
|---|---|---|---|---|
| 8.0.100 | 17.8 | 17,7 | Net7.0 | Net8.0 |
| 8.0.200 | 17,9 | 17.8 | Net8.0 | Net8.0 |
| 8.0.300 | 17.10 | 17.8 | Net8.0 | Net8.0 |
| 8.0.400 | 17,11 | 17.8 | Net8.0 | Net8.0 |
| 9.0.100 | 17.12 | 17,11 | Net8.0 | Net9.0 |
| 9.0.200 | 17.13 | 17.12 | Net9.0 | Net9.0 |
| 9.0.300 | 17.14 | 17.12 | Net9.0 | Net9.0 |
| 10.0.100 | 18.0 | 17.14 | Net9.0 | Net10.0 |
| 10.0.200 | 18.4 | 18.0 | Net10.0 | Net10.0 |
Hinweis
Die Tabelle zeigt, wie diese Versionsverwaltungsregeln angewendet werden, beginnend mit .NET SDK 7.0.100 und .NET SDK 6.0.300. Zudem wird erläutert, wie die Richtlinie bei Verfügbarkeit auf zuvor veröffentlichte Versionen des .NET SDK angewendet worden wäre. Die Anforderungen für frühere Versionen des SDK ändern sich jedoch nicht. Dies bedeutet, dass die mindestens erforderliche Visual Studio-Version für .NET SDK 6.0.100 oder 6.0.200 die Version 16.10 bleibt.
net8.0 als Ziel wird offiziell nur in Visual Studio 17.8 und höher unterstützt.
Das Targeting von net9.0 wird nur in Visual Studio ab Version 17.12 offiziell unterstützt.
Die Zielbestimmung net10.0 wird offiziell nur in Visual Studio 18.0+ unterstützt.
Für eine konsistente Toolnutzung sollten Sie zum Erstellen Ihrer Anwendung nach Möglichkeit dotnet build anstelle von msbuild verwenden.
SDK- und Visual Studio-Unterstützungsmatrix
Während die meisten Entwickler das .NET SDK mit ihrer Visual Studio-Version gebündelt verwenden, umfassen einige Konfigurationen nicht übereinstimmende SDK- und Visual Studio-Versionen. Es gibt keine Garantie, dass jede Visual Studio-Version mit jedem .NET SDK funktioniert. Die am häufigsten verwendeten Konfigurationen werden getestet, um eine optimale Kompatibilität sicherzustellen.
Abwärts- und Vorwärtskompatibilität
-
Primäre unterstützte Konfiguration: Verwenden der SDK-Version, die mit Ihrer Visual Studio-Installation gebündelt ist
- Visual Studio 17.14 und .NET 9.0.3xx
- Visual Studio 18.0 und .NET 10.0.1xx
- Abwärtskompatibilität: Die Verwendung des neuesten Featurebands der vorherigen SDK-Version (z. B. 8.0.4xx in Visual Studio 17.14) wird mit optimaler Kompatibilität unterstützt. Das .NET-Team bestimmt, wann Korrekturen basierend auf Risiko- und Kundenwirkungen zurückportiert werden sollen. Während SDKs, die älter als das neueste der vorherigen Band sind, möglicherweise funktionieren, testt das .NET-Team sie nicht oder bemüht sich um eine Kompatibilität.
- Forward compatibility: Die Verwendung eines neueren SDKs (zum Beispiel .NET 10 SDK in Visual Studio 17.14) ist ohne Blockierung erlaubt, aber das Anvisieren neuerer Laufzeiten in älteren Visual Studio-Versionen wird nicht unterstützt und führt zu einer Build-Warnung.
Leitlinien
Verwenden Sie das SDK, das mit Ihrer Visual Studio-Instanz (oder dem neuesten in CI oder Visual Studio Code verfügbar) geliefert wurde, da diese Version immer über die neuesten Features verfügt, einschließlich Sicherheitsupdates.
Unterstützung für das Targeting auf niedrigerer Ebene
Das .NET SDK verwaltet die Zielunterstützung für nicht mehr unterstützte .NET-Versionen. Das 10.0.100 SDK kann Apps erstellen, die net9.0 bis hinunter zu netcoreapp1.0 ausgerichtet sind.
Leitprinzipien
- Vorhandene Unterstützung beibehalten: Die Zielunterstützung für Out-of-Support-Versionen bleibt im SDK ohne aktive Entfernung erhalten. Kunden, die ihr SDK oder ihre Visual Studio-Version aktualisieren, sollten nicht erleben, dass ihre Builds einfach dadurch fehlschlagen, dass sie eine ältere .NET-Version anvisieren.
- Neue Features: Neue SDK-Features sind nicht erforderlich, um Out-of-Support-Versionen zu unterstützen, es sei denn, die Ausnahme dieser Unterstützung stellt erhebliche Kosten oder Risiken dar.
- Problembehebungen: Wenn Probleme auftreten, sobald sie auf nicht mehr unterstützte Versionen abzielen, wird basierend auf den Kosten der Behebung eine Lösung angewendet. Ziel ist es, zu verhindern, dass Kunden durch das Upgrade gestört werden.
Versionsverwaltung für Vorschauversionen
Hauptversionen des .NET SDK werden in der Regel innerhalb weniger Tage nach einer Visual Studio-Vorschauversion veröffentlicht. Obwohl es möglicherweise andere Kombinationen gibt, die funktionieren, wird nur die zuletzt veröffentlichte Vorschau getestet und offiziell unterstützt. Die folgende Tabelle zeigt, mit welcher Visual Studio-Version jede .NET-Vorschauversion vor der Veröffentlichung getestet wurde.
| SDK-Vorschauversion | Visual Studio-Version |
|---|---|
| 10.0.100 RC 1 | 18.0.0 Insider (11010.61) |
| 10.0.100 RC 2 | 18.0.0 Insider (11111.16) |
| 11.0.100 Vorschau 1 | 18.4.0 Insider |
| 11.0.100 Preview 2 | 18.5.0 Insider |
Verweis
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
