From f429df7b226cf567aa2a44bb09a10c3a9069fefd Mon Sep 17 00:00:00 2001 From: Marc Paine Date: Tue, 10 Dec 2024 16:33:00 -0800 Subject: [PATCH] Add summary of our .NET SDK upgrade in visual Studio (#43866) --- docs/core/porting/versioning-sdk-msbuild-vs.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/core/porting/versioning-sdk-msbuild-vs.md b/docs/core/porting/versioning-sdk-msbuild-vs.md index e1310c15a8808..18a4ba8f87f45 100644 --- a/docs/core/porting/versioning-sdk-msbuild-vs.md +++ b/docs/core/porting/versioning-sdk-msbuild-vs.md @@ -16,6 +16,11 @@ The first part of the .NET SDK version matches the .NET version that it includes For example, version 7.0.203 ships with .NET 7, is the second minor Visual Studio release since 7.0.100 first came out, and is the third patch since 7.0.200 released. +An installation of Visual Studio includes a single matching copy of the .NET SDK. If you update your Visual Studio instance, the .NET SDK installed by Visual Studio is also updated, including across .NET SDK feature bands and major bands. If you want to use a different .NET SDK than what's installed by Visual Studio, you can install it from the [.NET download page](https://aka.ms/dotnet/download), and Visual Studio upgrade won't touch that version. You're responsible for updating that copy of the .NET SDK from then on. + +> [!NOTE] +The .NET SDK supports targeting down-level versions of .NET, so we recommend always updating your .NET SDK along with your Visual Studio version. + ## Lifecycle The support timeframe for the SDK typically matches that of the Visual Studio version it's included in.