From 38e355fdd95c412fba5ea8a8728325208e7184fc Mon Sep 17 00:00:00 2001 From: Meaghan Osagie Date: Fri, 7 Nov 2025 10:16:26 -0800 Subject: [PATCH 1/9] update details to show .net 10 as latest release --- api/index.md | 6 ++-- .../how-to-detect-installed-versions.md | 34 +++++++++---------- .../install/includes/supported-versions.md | 3 +- docs/core/install/linux-scripted-manual.md | 25 +++++++------- docs/core/install/linux-snap-sdk.md | 3 +- docs/core/install/linux-ubuntu-decision.md | 21 +++++++----- docs/core/project-sdk/msbuild-props.md | 6 +++- docs/core/tools/dotnet-new-sdk-templates.md | 21 ++++++------ docs/core/versions/index.md | 4 +-- docs/fundamentals/implementations.md | 4 +-- .../choosing-core-framework-server.md | 4 +-- docs/standard/frameworks.md | 13 ++++++- docs/standard/net-standard.md | 4 +-- docs/welcome.md | 6 ++-- includes/net-standard-1.0.md | 2 +- includes/net-standard-1.1.md | 18 +++++----- includes/net-standard-1.2.md | 20 +++++------ includes/net-standard-1.3.md | 20 +++++------ includes/net-standard-1.4.md | 20 +++++------ includes/net-standard-1.5.md | 20 +++++------ includes/net-standard-1.6.md | 20 +++++------ includes/net-standard-2.0.md | 2 +- includes/net-standard-2.1.md | 20 +++++------ includes/preprocessor-symbols.md | 2 +- 24 files changed, 160 insertions(+), 138 deletions(-) diff --git a/api/index.md b/api/index.md index e15cd1a4fb7ae..5438d58656041 100644 --- a/api/index.md +++ b/api/index.md @@ -3,12 +3,12 @@ description: Explore Microsoft's comprehensive .NET API browser. Your ultimate r layout: ApiBrowserPage hide_bc: true title: .NET API browser -quickFilterColumn1: net-9.0,netframework-4.8.1,netstandard-2.1 -quickFilterColumn2: aspnetcore-9.0,dotnet-aspire-9.0,net-maui-9.0 +quickFilterColumn1: net-10.0,netframework-4.8.1,netstandard-2.1 +quickFilterColumn2: aspnetcore-10.0,dotnet-aspire-9.0,net-maui-10.0 quickFilterColumn3: efcore-9.0,azure-dotnet,ml-dotnet ms.topic: landing-page ms.custom: "updateeachrelease" -ms.date: 01/23/2025 +ms.date: 11/07/2025 --- # .NET API browser diff --git a/docs/core/install/how-to-detect-installed-versions.md b/docs/core/install/how-to-detect-installed-versions.md index 91b10e84594b3..ccbcfb1e6af11 100644 --- a/docs/core/install/how-to-detect-installed-versions.md +++ b/docs/core/install/how-to-detect-installed-versions.md @@ -3,7 +3,7 @@ title: Check installed .NET versions on Windows, Linux, and macOS description: Learn how to list which versions of .NET are installed on your computer. This includes the .NET runtime and SDK. author: adegeo ms.author: adegeo -ms.date: 11/11/2024 +ms.date: 11/07/2025 ms.custom: updateeachrelease, linux-related-content zone_pivot_groups: operating-systems-set-one --- @@ -29,11 +29,10 @@ You get output similar to the following. ::: zone pivot="os-windows" ```console -3.1.424 [C:\program files\dotnet\sdk] -5.0.100 [C:\program files\dotnet\sdk] -6.0.402 [C:\program files\dotnet\sdk] 7.0.404 [C:\program files\dotnet\sdk] 8.0.100 [C:\program files\dotnet\sdk] +9.0.306 [C:\program files\dotnet\sdk] +10.0.100 [C:\program files\dotnet\sdk] ``` ::: zone-end @@ -41,11 +40,10 @@ You get output similar to the following. ::: zone pivot="os-linux" ```bash -3.1.424 [/home/user/dotnet/sdk] -5.0.100 [/home/user/dotnet/sdk] -6.0.402 [/home/user/dotnet/sdk] 7.0.404 [/home/user/dotnet/sdk] 8.0.100 [/home/user/dotnet/sdk] +9.0.306 [/home/user/dotnet/sdk] +10.0.100 [/home/user/dotnet/sdk] ``` ::: zone-end @@ -53,11 +51,10 @@ You get output similar to the following. ::: zone pivot="os-macos" ```bash -3.1.424 [/usr/local/share/dotnet/sdk] -5.0.100 [/usr/local/share/dotnet/sdk] -6.0.402 [/usr/local/share/dotnet/sdk] 7.0.404 [/usr/local/share/dotnet/sdk] 8.0.100 [/usr/local/share/dotnet/sdk] +9.0.306 [/usr/local/share/dotnet/sdk] +10.0.100 [/usr/local/share/dotnet/sdk] ``` ::: zone-end @@ -75,19 +72,18 @@ You get output similar to the following. ::: zone pivot="os-windows" ```console -Microsoft.AspNetCore.App 3.1.30 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App] -Microsoft.AspNetCore.App 6.0.10 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App] Microsoft.AspNetCore.App 7.0.5 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App] Microsoft.AspNetCore.App 8.0.0 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App] -Microsoft.NETCore.App 3.1.30 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] -Microsoft.NETCore.App 5.0.17 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] -Microsoft.NETCore.App 6.0.10 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] +Microsoft.AspNetCore.App 9.0.10 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App] +Microsoft.AspNetCore.App 10.0.0 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App] Microsoft.NETCore.App 7.0.5 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] Microsoft.NETCore.App 8.0.0 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] -Microsoft.WindowsDesktop.App 3.1.30 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App] -Microsoft.WindowsDesktop.App 6.0.10 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App] +Microsoft.NETCore.App 9.0.10 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] +Microsoft.NETCore.App 10.0.0 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] Microsoft.WindowsDesktop.App 7.0.5 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App] Microsoft.WindowsDesktop.App 8.0.0 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App] +Microsoft.WindowsDesktop.App 9.0.10 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App] +Microsoft.WindowsDesktop.App 10.0.0 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App] ``` ::: zone-end @@ -109,6 +105,8 @@ Microsoft.NETCore.App 5.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App] Microsoft.NETCore.App 6.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App] Microsoft.NETCore.App 7.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App] Microsoft.NETCore.App 8.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App] +Microsoft.NETCore.App 9.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App] +Microsoft.NETCore.App 10.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App] ``` ::: zone-end @@ -130,6 +128,8 @@ Microsoft.NETCore.App 5.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.Ap Microsoft.NETCore.App 6.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] Microsoft.NETCore.App 7.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] Microsoft.NETCore.App 8.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] +Microsoft.NETCore.App 9.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] +Microsoft.NETCore.App 10.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] ``` ::: zone-end diff --git a/docs/core/install/includes/supported-versions.md b/docs/core/install/includes/supported-versions.md index 71565cc9f3189..a725a81ce4514 100644 --- a/docs/core/install/includes/supported-versions.md +++ b/docs/core/install/includes/supported-versions.md @@ -1,7 +1,7 @@ --- author: adegeo ms.author: adegeo -ms.date: 08/26/2025 +ms.date: 11/07/2025 ms.topic: include --- @@ -9,6 +9,7 @@ Microsoft publishes .NET under two different support policies, Long Term Support The versions of .NET that are currently supported by Microsoft are: +- 10.0 (STS)—Support ends **November 14, 2028**. - 9.0 (STS)—Support ends **November 10, 2026**. - 8.0 (LTS)—Support ends **November 10, 2026**. diff --git a/docs/core/install/linux-scripted-manual.md b/docs/core/install/linux-scripted-manual.md index 3821ec806b325..cabac57fe6b87 100644 --- a/docs/core/install/linux-scripted-manual.md +++ b/docs/core/install/linux-scripted-manual.md @@ -3,7 +3,7 @@ title: Install .NET on Linux without using a package manager description: Demonstrates how to install the .NET SDK and the .NET Runtime on Linux without a package manager. Use the install script or manually extract the binaries. author: adegeo ms.author: adegeo -ms.date: 08/26/2025 +ms.date: 11/07/2025 ms.custom: linux-related-content, updateeachrelease --- @@ -20,17 +20,17 @@ There are two types of supported releases, Long Term Support (LTS) and Standard The following table lists the support status of each version of .NET (and .NET Core): | ✔️ Supported | ❌ Out of support | -|-------------|------------------| -| 9 (STS) | 7 | -| 8 (LTS) | 6 (LTS) | -| | 5 | -| | 3.1 | -| | 3.0 | -| | 2.2 | -| | 2.1 | -| | 2.0 | -| | 1.1 | -| | 1.0 | +|---------------|-------------------| +| 10 (STS) | 7 | +| 9 (STS) | 6 (LTS) | +| 8 (LTS) | 5 | +| | 3.1 | +| | 3.0 | +| | 2.2 | +| | 2.1 | +| | 2.0 | +| | 1.1 | +| | 1.0 | ## Dependencies @@ -122,6 +122,7 @@ As an alternative to the package managers, you can download and manually install Download a **binary** release for either the SDK or the runtime from one of the following sites. The .NET SDK includes the corresponding runtime: +- ✔️ [.NET 10 downloads](https://dotnet.microsoft.com/download/dotnet/10.0) - ✔️ [.NET 9 downloads](https://dotnet.microsoft.com/download/dotnet/9.0) - ✔️ [.NET 8 downloads](https://dotnet.microsoft.com/download/dotnet/8.0) - [All .NET Core downloads](https://dotnet.microsoft.com/download/dotnet) diff --git a/docs/core/install/linux-snap-sdk.md b/docs/core/install/linux-snap-sdk.md index 6d29da59ade18..395048a04099d 100644 --- a/docs/core/install/linux-snap-sdk.md +++ b/docs/core/install/linux-snap-sdk.md @@ -3,7 +3,7 @@ title: Install .NET SDK on Linux with Snap description: Learn about how to install the .NET SDK snap package. Canonical maintains and supports .NET-related snap packages. author: adegeo ms.author: adegeo -ms.date: 11/11/2024 +ms.date: 11/07/2025 ms.topic: install-set-up-deploy ms.custom: linux-related-content, updateeachrelease #customer intent: As a Linux user, I want to install .NET SDK through Snap. @@ -58,6 +58,7 @@ The following table lists the package channels you can install: | .NET version | Snap package channel | |--------------|---------------------------------| +| 10 (STS) | *Not yet available | | 9 (STS) | *Not yet available | | 8 (LTS) | `8.0/stable`
`lts/stable` | | 7 (STS) | `7.0/stable` (out of support) | diff --git a/docs/core/install/linux-ubuntu-decision.md b/docs/core/install/linux-ubuntu-decision.md index 96d16b1b9b605..9fa05c05d5a7a 100644 --- a/docs/core/install/linux-ubuntu-decision.md +++ b/docs/core/install/linux-ubuntu-decision.md @@ -3,7 +3,7 @@ title: .NET and Ubuntu overview description: Learn about the ways you can install .NET on Ubuntu, either from the built-in package feed, the .NET backports repository, or the Microsoft repository. author: adegeo ms.author: adegeo -ms.date: 03/27/2025 +ms.date: 11/07/2025 ms.custom: updateeachrelease, linux-related-content --- @@ -21,9 +21,9 @@ The following table is a list of currently supported .NET releases and the versi | Ubuntu | Supported .NET versions | Available in
built-in Ubuntu feed | [Available in
.NET backports
Ubuntu feed](#register-the-ubuntu-net-backports-package-repository) | [Available in
Microsoft feed](#register-the-microsoft-package-repository) | |--------------------------------------------------------------------|-------------------------|--------------------------------------|--------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------| -| [25.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2504) | 9.0, 8.0 | 9.0, 8.0 | None | None | -| [24.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404) | 9.0, 8.0 | 8.0 | 9.0, 7.0, 6.0 | None | -| [22.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2204) | 9.0, 8.0 | 8.0, 7.0, 6.0 | 9.0 | 8.0, 7.0, 6.0, 3.1 | +| [25.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2504) | 10.0, 9.0, 8.0 | 10.0, 9.0, 8.0 | None | None | +| [24.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404) | 10.0, 9.0, 8.0 | 8.0 | 10.0, 9.0, 7.0, 6.0 | None | +| [22.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2204) | 10.0, 9.0, 8.0 | 8.0, 7.0, 6.0 | 10.0, 9.0 | 8.0, 7.0, 6.0, 3.1 | When an [Ubuntu version](https://wiki.ubuntu.com/Releases) reaches the end of its support period, .NET is no longer supported with that particular Ubuntu version. @@ -238,10 +238,13 @@ The following sections describe how to manage .NET through the package manager. ### Install .NET -Install .NET through the package manager with the `sudo apt install ` command. Replace `` with the name of the .NET package you want to install. For example, to install .NET SDK 9.0, use the command `sudo apt install dotnet-sdk-9.0`. The following table lists the currently supported .NET packages (which [might vary by your Ubuntu version](#supported-distributions)): +Install .NET through the package manager with the `sudo apt install ` command. Replace `` with the name of the .NET package you want to install. For example, to install .NET SDK 10.0, use the command `sudo apt install dotnet-sdk-10.0`. The following table lists the currently supported .NET packages (which [might vary by your Ubuntu version](#supported-distributions)): -|| Product | Type | Package | -|---------|--------------|---------|--------------------------| +| Product | Type | Package | +|------------|--------------|---------|--------------------------| +| **10.0** | ASP.NET Core | Runtime | `aspnetcore-runtime-10.0`| +| **10.0** | .NET | Runtime | `dotnet-runtime-10.0` | +| **10.0** | .NET | SDK | `dotnet-sdk-10.0` | | **9.0** | ASP.NET Core | Runtime | `aspnetcore-runtime-9.0` | | **9.0** | .NET | Runtime | `dotnet-runtime-9.0` | | **9.0** | .NET | SDK | `dotnet-sdk-9.0` | @@ -266,11 +269,11 @@ For more information, see [Uninstall .NET](remove-runtime-sdk-versions.md?pivots ### Update .NET -If you installed .NET through a package manager, you can upgrade the package with the `apt upgrade` command. For example, the following commands upgrade the `dotnet-sdk-9.0` package with the latest version: +If you installed .NET through a package manager, you can upgrade the package with the `apt upgrade` command. For example, the following commands upgrade the `dotnet-sdk-10.0` package with the latest version: ```bash sudo apt update -sudo apt upgrade dotnet-sdk-9.0 +sudo apt upgrade dotnet-sdk-10.0 ``` > [!TIP] diff --git a/docs/core/project-sdk/msbuild-props.md b/docs/core/project-sdk/msbuild-props.md index dd8f1a3198b2d..6c96ddd2ff25a 100644 --- a/docs/core/project-sdk/msbuild-props.md +++ b/docs/core/project-sdk/msbuild-props.md @@ -1,7 +1,7 @@ --- title: MSBuild properties for Microsoft.NET.Sdk description: Reference for the MSBuild properties and items that are understood by the .NET SDK. -ms.date: 09/30/2025 +ms.date: 11/07/2025 ms.topic: reference ms.custom: updateeachrelease --- @@ -977,6 +977,10 @@ The following table shows the values you can specify. | `latest-` | The latest code analyzers that have been released are used. The `` value determines which rules are enabled. | | `preview` | The latest code analyzers are used, even if they are in preview. | | `preview-` | The latest code analyzers are used, even if they are in preview. The `` value determines which rules are enabled. | +| `10.0` | The set of rules that was available for the .NET 10 release is used, even if newer rules are available. | +| `10.0-` | The set of rules that was available for the .NET 10 release is used, even if newer rules are available. The `` value determines which rules are enabled. | +| `10` | The set of rules that was available for the .NET 10 release is used, even if newer rules are available. | +| `10-` | The set of rules that was available for the .NET 10 release is used, even if newer rules are available. The `` value determines which rules are enabled. | | `9.0` | The set of rules that was available for the .NET 9 release is used, even if newer rules are available. | | `9.0-` | The set of rules that was available for the .NET 9 release is used, even if newer rules are available. The `` value determines which rules are enabled. | | `9` | The set of rules that was available for the .NET 9 release is used, even if newer rules are available. | diff --git a/docs/core/tools/dotnet-new-sdk-templates.md b/docs/core/tools/dotnet-new-sdk-templates.md index 3a112f98f10bd..5b060f1ca27d3 100644 --- a/docs/core/tools/dotnet-new-sdk-templates.md +++ b/docs/core/tools/dotnet-new-sdk-templates.md @@ -3,7 +3,7 @@ title: .NET default templates for 'dotnet new' description: Learn about 'dotnet new' templates that ship with the .NET SDK. ms.custom: updateeachrelease no-loc: [Blazor, WebAssembly] -ms.date: 08/29/2025 +ms.date: 11/07/2025 --- # Default templates for `dotnet new` @@ -25,8 +25,8 @@ The following table shows the templates that come preinstalled with the .NET SDK | Templates | Short name | Language | Tags | Introduced | |-----------------------------|-----------------------------------|----------|-------------------------|------------| -| ASP.NET Core API | [`webapiaot`](#webapiaot) | [C#] | Web/Web API/API/Service | 8.0 | -| ASP.NET Core API controller | [`apicontroller`](#apicontroller) | [C#] | Web/ASP.NET | 8.0 | +| ASP.NET Core API | [`webapiaot`](#webapiaot) | [C#] | Web/Web API/API/Service | 10.0 | +| ASP.NET Core API controller | [`apicontroller`](#apicontroller) | [C#] | Web/ASP.NET | 10.0 | | ASP.NET Core Empty | [`web`](#web) | [C#], F# | Web/Empty | 1.0 | | ASP.NET Core Web API | [`webapi`](#webapi) | [C#], F# | Web/Web API/API/Service/WebAPI | 1.0 | | ASP.NET Core Web App (Model-View-Controller) | [`mvc`](#web-options) | [C#], F# | Web/MVC | 1.0 | @@ -205,9 +205,9 @@ Creates a *Directory.Build.targets* file for customizing MSBuild targets and tas | SDK version | Default value | |-------------|---------------| + | 10.0 | `net10.0` | | 9.0 | `net9.0` | | 8.0 | `net8.0` | - | 7.0 | `net7.0` | The ability to create a project for an earlier TFM depends on having that version of the SDK installed. For example, if you have only the .NET 9 SDK installed, then the only value available for `--framework` is `net9.0`. If you install, for example, the .NET 8 SDK, the value `net8.0` becomes available for `--framework`. So by specifying `--framework net8.0` you can target .NET 8 even while running `dotnet new` in the .NET 9 SDK. @@ -289,9 +289,9 @@ The ability to create a project for an earlier TFM depends on having that versio | SDK version | Default value | |-------------|---------------| + | 10.0 | `net10.0` | | 9.0 | `net9.0` | | 8.0 | `net8.0` | - | 7.0 | `net7.0` | The ability to create a project for an earlier TFM depends on having that version of the SDK installed. For example, if you have only the .NET 9 SDK installed, then the only value available for `--framework` is `net9.0`. If you install, for example, the .NET 8 SDK, the value `net8.0` becomes available for `--framework`. So by specifying `--framework net8.0` you can target .NET 8 even while running `dotnet new` in the .NET 9 SDK. @@ -315,9 +315,9 @@ The ability to create a project for an earlier TFM depends on having that versio | SDK version | Default value | |-------------|---------------| + | 10.0 | `net10.0` | | 9.0 | `net9.0` | | 8.0 | `net8.0` | - | 7.0 | `net7.0` | The ability to create a project for an earlier TFM depends on having that version of the SDK installed. For example, if you have only the .NET 9 SDK installed, then the only value available for `--framework` is `net9.0`. If you install, for example, the .NET 8 SDK, the value `net8.0` becomes available for `--framework`. So by specifying `--framework net8.0` you can target .NET 8 even while running `dotnet new` in the .NET 9 SDK. @@ -419,9 +419,9 @@ The ability to create a project for an earlier TFM depends on having that versio | SDK version | Default value | |-------------|---------------| + | 10.0 | `net10.0` | | 9.0 | `net9.0` | | 8.0 | `net8.0` | - | 7.0 | `net7.0` | To create a project that targets a framework earlier than the SDK that you're using, see [`--framework` for `console` projects](#template-options) earlier in this article. @@ -520,9 +520,9 @@ The ability to create a project for an earlier TFM depends on having that versio | SDK version | Default value | |-------------|---------------| + | 10.0 | `net10.0` | | 9.0 | `net9.0` | | 8.0 | `net8.0` | - | 7.0 | `net7.0` | To create a project that targets a framework earlier than the SDK that you're using, see [`--framework` for `console` projects](#template-options) earlier in this article. @@ -580,6 +580,7 @@ Creates a web API project with AOT publish enabled. For more information, see [N | SDK version | Default value | |-------------|---------------| + | 10.0 | `net10.0` | | 9.0 | `net9.0` | | 8.0 | `net8.0` | @@ -664,9 +665,9 @@ Creates a web API project with AOT publish enabled. For more information, see [N | SDK version | Default value | |-------------|---------------| + | 10.0 | `net10.0` | | 9.0 | `net9.0` | | 8.0 | `net8.0` | - | 7.0 | `net7.0` | To create a project that targets a framework earlier than the SDK that you're using, see [`--framework` for `console` projects](#template-options) earlier in this article. @@ -891,9 +892,9 @@ The following table shows templates that have been discontinued and no longer co | SDK version | Default value | |-------------|---------------| + | 10.0 | `net10.0` | | 9.0 | `net9.0` | | 8.0 | `net8.0` | - | 7.0 | `net7.0` | To create a project that targets a framework earlier than the SDK that you're using, see [`--framework` for `console` projects](#template-options) earlier in this article. diff --git a/docs/core/versions/index.md b/docs/core/versions/index.md index 468889f684c0e..64511f59c8ac6 100644 --- a/docs/core/versions/index.md +++ b/docs/core/versions/index.md @@ -2,7 +2,7 @@ title: How the .NET Runtime and SDK are versioned description: This article explains how the .NET SDK and Runtime are versioned (similar to semantic versioning). ms.custom: updateeachrelease -ms.date: 08/26/2025 +ms.date: 11/07/2025 --- # How .NET is versioned @@ -60,7 +60,7 @@ The optional `PRERELEASE` and `BUILDNUMBER` parts are never part of supported re - API introduced breaking changes. There's a high bar to accepting breaking changes. - A newer `MAJOR` version of an existing dependency is adopted. - Major releases happen once a year, even-numbered versions are long-term supported (LTS) releases. The first LTS release using this versioning scheme is .NET 6. The latest non-LTS version is .NET 9. + Major releases happen once a year, even-numbered versions are long-term supported (LTS) releases. The first LTS release using this versioning scheme is .NET 6. The latest non-LTS version is .NET 10. - `MINOR` is incremented when: diff --git a/docs/fundamentals/implementations.md b/docs/fundamentals/implementations.md index cf2818024ebcf..9d166adbcd0b7 100644 --- a/docs/fundamentals/implementations.md +++ b/docs/fundamentals/implementations.md @@ -1,7 +1,7 @@ --- title: .NET implementations description: Describes the various .NET implementations, including .NET 5+, .NET Framework, and Mono. -ms.date: 11/22/2024 +ms.date: 11/07/2025 ms.custom: updateeachrelease --- # .NET implementations @@ -25,7 +25,7 @@ There are three main .NET implementations: .NET, previously referred to as .NET Core, is currently the primary implementation. .NET is built on a single code base that supports multiple platforms and many workloads, such as Windows desktop apps and cross-platform console apps, cloud services, and websites. [Some workloads](../core/whats-new/dotnet-6.md#sdk-workloads), such as .NET WebAssembly build tools, are available as optional installations. -.NET 9 is the latest version of this .NET implementation. It implements .NET Standard, so code that targets .NET Standard can run on .NET. [ASP.NET Core](https://dotnet.microsoft.com/learn/aspnet/what-is-aspnet-core), [Windows Forms](/dotnet/desktop/winforms/windows-forms-overview), and [Windows Presentation Foundation (WPF)](/dotnet/desktop/wpf/) all run on .NET. +.NET 10 is the latest version of this .NET implementation. It implements .NET Standard, so code that targets .NET Standard can run on .NET. [ASP.NET Core](https://dotnet.microsoft.com/learn/aspnet/what-is-aspnet-core), [Windows Forms](/dotnet/desktop/winforms/windows-forms-overview), and [Windows Presentation Foundation (WPF)](/dotnet/desktop/wpf/) all run on .NET. For more information, see the following resources: diff --git a/docs/standard/choosing-core-framework-server.md b/docs/standard/choosing-core-framework-server.md index e958f9805d486..38303b7d17734 100644 --- a/docs/standard/choosing-core-framework-server.md +++ b/docs/standard/choosing-core-framework-server.md @@ -1,12 +1,12 @@ --- title: Choose between .NET and .NET Framework for server apps description: A guide to help you decide which implementation of .NET to use when building a server app. -ms.date: 11/22/2024 +ms.date: 11/07/2025 ms.custom: updateeachrelease --- # .NET vs. .NET Framework for server apps -There are two supported [.NET implementations](glossary.md#implementation-of-net) for building server-side apps: .NET and .NET Framework. **The latest .NET version (currently .NET 9) is the preferred version of .NET to use for server development.** The reasons to continue using .NET Framework are specific and limited. +There are two supported [.NET implementations](glossary.md#implementation-of-net) for building server-side apps: .NET and .NET Framework. **The latest .NET version (currently .NET 10) is the preferred version of .NET to use for server development.** The reasons to continue using .NET Framework are specific and limited. | Implementation | Included versions | |----------------|-----------------------------------------------------| diff --git a/docs/standard/frameworks.md b/docs/standard/frameworks.md index 210d067106a5f..7519621e61e91 100644 --- a/docs/standard/frameworks.md +++ b/docs/standard/frameworks.md @@ -1,7 +1,7 @@ --- title: Target frameworks in SDK-style projects - .NET description: Learn about target frameworks for .NET apps and libraries. -ms.date: 04/07/2025 +ms.date: 11/07/2025 ms.service: dotnet ms.custom: updateeachrelease ms.subservice: standard-library @@ -26,6 +26,7 @@ The following table defines the most common target frameworks, how they're refer | Target framework | Latest
stable version | Target framework moniker (TFM) | Implemented
.NET Standard version | |:----------------:|:---------------------------:|:------------------------------:|:---------------------------------------:| +| .NET 10 | 10 | net10.0 | 2.1 | | .NET 9 | 9 | net9.0 | 2.1 | | .NET 8 | 8 | net8.0 | 2.1 | | .NET Standard | 2.1 | netstandard2.1 | N/A | @@ -95,6 +96,15 @@ The following table shows the compatibility of the .NET 5+ TFMs. | `net9.0-tizen` | (Subsequent version of `net8.0-tizen`) | | `net9.0-tvos` | (Subsequent version of `net8.0-tvos`) | | `net9.0-windows` | (Subsequent version of `net8.0-windows`) | +| `net10.0` | (Subsequent version of `net9.0`) | +| `net10.0-android` | (Subsequent version of `net9.0-android`) | +| `net10.0-browser` | (Subsequent version of `net9.0-browser`) | +| `net10.0-ios` | (Subsequent version of `net9.0-ios`) | +| `net10.0-maccatalyst`| (Subsequent version of `net9.0-maccatalyst`) | +| `net10.0-macos` | (Subsequent version of `net9.0-macos`) | +| `net10.0-tizen` | (Subsequent version of `net9.0-tizen`) | +| `net10.0-tvos` | (Subsequent version of `net9.0-tvos`) | +| `net10.0-windows` | (Subsequent version of `net9.0-windows`) | To make your app portable across different platforms but still have access to OS-specific APIs, you can target multiple OS-specific TFMs and add platform guards around OS-specific API calls using `#if` preprocessor directives. For a list of the available symbols, see [Preprocessor symbols](#preprocessor-symbols). @@ -120,6 +130,7 @@ The following table shows the *default* target platform version (TPV) for each . |--------------|--------:|-----:|-------------:|------:|-----:|------:|--------:| | .NET 8 | 34.0 | 17.2 | 17.2 | 14.2 | 17.1 | 10.0 | 7.0 | | .NET 9 | 35.0 | 18.0 | 18.0 | 15.0 | | 10.0 | 7.0 | +| .NET 10 | 36.0 | 18.0 | 18.0 | 26.0 | | 10.0 | 7.0 | Starting in .NET 9, when service releases introduce support for a later TPV (which will always have the same *major* version number as when the .NET version was initially released), the earliest supported TPV for that .NET version will remain supported. For example, for .NET 9, the earliest supported iOS version, 18.0, will remain supported, even when a service release adds support for the latest iOS 18.x version. **If you need to use the earliest bindings for a .NET release, use a specific OS version number in your TFM.** diff --git a/docs/standard/net-standard.md b/docs/standard/net-standard.md index 62b43be221521..d63cc79ff9bce 100644 --- a/docs/standard/net-standard.md +++ b/docs/standard/net-standard.md @@ -1,7 +1,7 @@ --- title: .NET Standard description: Learn about .NET Standard, its versions, and the .NET implementations that support it. -ms.date: 11/11/2024 +ms.date: 11/07/2025 ms.service: dotnet ms.subservice: standard-library ms.custom: "updateeachrelease" @@ -88,7 +88,7 @@ If you only need to consume .NET Standard 2.0 libraries in your projects, you ca ## .NET 5+ and .NET Standard -.NET 5, .NET 6, .NET 7, .NET 8, and .NET 9 are single products with a uniform set of capabilities and APIs that can be used for Windows desktop apps and cross-platform console apps, cloud services, and websites. The .NET 9 [TFMs](frameworks.md), for example, reflect this broad range of scenarios: +.NET 5 and later are single products with a uniform set of capabilities and APIs that can be used for Windows desktop apps and cross-platform console apps, cloud services, and websites. The .NET 9 [TFMs](frameworks.md), for example, reflect this broad range of scenarios: - `net9.0` diff --git a/docs/welcome.md b/docs/welcome.md index 54da27453c9a5..c839edf746ca8 100644 --- a/docs/welcome.md +++ b/docs/welcome.md @@ -1,7 +1,7 @@ --- title: Welcome to .NET description: Getting started with the .NET family of technologies. -ms.date: 11/22/2024 +ms.date: 11/07/2025 ms.custom: "updateeachrelease" --- # Welcome to .NET @@ -25,8 +25,8 @@ Also follow the latest .NET events: For information about the latest features added to the .NET implementations and supported languages, see the following articles: -- [What's new in .NET 9](core/whats-new/dotnet-9/overview.md) -- [What's new in C# 13](./csharp/whats-new/csharp-13.md) +- [What's new in .NET 10](core/whats-new/dotnet-10/overview.md) +- [What's new in C# 14](./csharp/whats-new/csharp-14.md) - [What's new for Visual Basic](visual-basic/whats-new/index.md) - [What's new in .NET Framework](framework/whats-new/index.md) diff --git a/includes/net-standard-1.0.md b/includes/net-standard-1.0.md index bc0490c3ce312..61662d4af4451 100644 --- a/includes/net-standard-1.0.md +++ b/includes/net-standard-1.0.md @@ -2,7 +2,7 @@ | .NET implementation | Version support | | -------------------------- | ------------------------------------------------------------------- | -| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0 | +| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0 | | .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | | Mono | 4.6, 5.4, 6.4 | | Xamarin.iOS | 10.0, 10.14, 12.16 | diff --git a/includes/net-standard-1.1.md b/includes/net-standard-1.1.md index 7efc732613a73..3f8c6baee755b 100644 --- a/includes/net-standard-1.1.md +++ b/includes/net-standard-1.1.md @@ -1,15 +1,15 @@ .NET Standard 1.1 has 10,239 of the 37,118 available APIs. -| .NET implementation | Version support | -|----------------------------|------------------------------------------------------------| -| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0 | +| .NET implementation | Version support | +|----------------------------|---------------------------------------------------------------------| +| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0 | | .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | -| Mono | 4.6, 5.4, 6.4 | -| Xamarin.iOS | 10.0, 10.14, 12.16 | -| Xamarin.Mac | 3.0, 3.8, 5.16 | -| Xamarin.Android | 7.0, 8.0, 10.0 | -| Universal Windows Platform | 8.0, 8.1, 10.0, 10.0.16299, TBD | -| Unity | 2018.1 | +| Mono | 4.6, 5.4, 6.4 | +| Xamarin.iOS | 10.0, 10.14, 12.16 | +| Xamarin.Mac | 3.0, 3.8, 5.16 | +| Xamarin.Android | 7.0, 8.0, 10.0 | +| Universal Windows Platform | 8.0, 8.1, 10.0, 10.0.16299, TBD | +| Unity | 2018.1 | For more information, see [.NET Standard 1.1][1.1]. For an interactive table, see [.NET Standard versions](https://dotnet.microsoft.com/platform/dotnet-standard#versions). diff --git a/includes/net-standard-1.2.md b/includes/net-standard-1.2.md index 760a3fb47013d..73f8f6a352fe2 100644 --- a/includes/net-standard-1.2.md +++ b/includes/net-standard-1.2.md @@ -1,15 +1,15 @@ .NET Standard 1.2 has 10,285 of the 37,118 available APIs. -| .NET implementation | Version support | -| -------------------------- | -------------------------------------------------------------- | -| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0 | -| .NET Framework | 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | -| Mono | 4.6, 5.4, 6.4 | -| Xamarin.iOS | 10.0, 10.14, 12.16 | -| Xamarin.Mac | 3.0, 3.8, 5.16 | -| Xamarin.Android | 7.0, 8.0, 10.0 | -| Universal Windows Platform | 8.1, 10.0, 10.0.16299, TBD | -| Unity | 2018.1 | +| .NET implementation | Version support | +| -------------------------- | ----------------------------------------------------------------- | +| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0 , 10.0 | +| .NET Framework | 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | +| Mono | 4.6, 5.4, 6.4 | +| Xamarin.iOS | 10.0, 10.14, 12.16 | +| Xamarin.Mac | 3.0, 3.8, 5.16 | +| Xamarin.Android | 7.0, 8.0, 10.0 | +| Universal Windows Platform | 8.1, 10.0, 10.0.16299, TBD | +| Unity | 2018.1 | For more information, see [.NET Standard 1.2][1.2]. For an interactive table, see [.NET Standard versions](https://dotnet.microsoft.com/platform/dotnet-standard#versions). diff --git a/includes/net-standard-1.3.md b/includes/net-standard-1.3.md index 787006d0f14c9..652df71d6473c 100644 --- a/includes/net-standard-1.3.md +++ b/includes/net-standard-1.3.md @@ -1,15 +1,15 @@ .NET Standard 1.3 has 13,122 of the 37,118 available APIs. -| .NET implementation | Version support | -|----------------------------|------------------------------------------------------------| -| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0 | -| .NET Framework | 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | -| Mono | 4.6, 5.4, 6.4 | -| Xamarin.iOS | 10.0, 10.14, 12.16 | -| Xamarin.Mac | 3.0, 3.8, 5.16 | -| Xamarin.Android | 7.0, 8.0, 10.0 | -| Universal Windows Platform | 10.0, 10.0.16299, TBD | -| Unity | 2018.1 | +| .NET implementation | Version support | +|----------------------------|------------------------------------------------------------------| +| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0 | +| .NET Framework | 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | +| Mono | 4.6, 5.4, 6.4 | +| Xamarin.iOS | 10.0, 10.14, 12.16 | +| Xamarin.Mac | 3.0, 3.8, 5.16 | +| Xamarin.Android | 7.0, 8.0, 10.0 | +| Universal Windows Platform | 10.0, 10.0.16299, TBD | +| Unity | 2018.1 | For more information, see [.NET Standard 1.3][1.3]. For an interactive table, see [.NET Standard versions](https://dotnet.microsoft.com/platform/dotnet-standard#versions). diff --git a/includes/net-standard-1.4.md b/includes/net-standard-1.4.md index 79da9c6f80a7b..e348d1983db33 100644 --- a/includes/net-standard-1.4.md +++ b/includes/net-standard-1.4.md @@ -1,15 +1,15 @@ .NET Standard 1.4 has 13,140 of the 37,118 available APIs. -| .NET implementation | Version support | -|----------------------------|------------------------------------------------------------| -| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0 | -| .NET Framework | 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | -| Mono | 4.6, 5.4, 6.4 | -| Xamarin.iOS | 10.0, 10.14, 12.16 | -| Xamarin.Mac | 3.0, 3.8, 5.16 | -| Xamarin.Android | 7.0, 8.0, 10.0 | -| Universal Windows Platform | 10.0, 10.0.16299, TBD | -| Unity | 2018.1 | +| .NET implementation | Version support | +|----------------------------|------------------------------------------------------------------| +| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0 | +| .NET Framework | 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | +| Mono | 4.6, 5.4, 6.4 | +| Xamarin.iOS | 10.0, 10.14, 12.16 | +| Xamarin.Mac | 3.0, 3.8, 5.16 | +| Xamarin.Android | 7.0, 8.0, 10.0 | +| Universal Windows Platform | 10.0, 10.0.16299, TBD | +| Unity | 2018.1 | For more information, see [.NET Standard 1.4][1.4]. For an interactive table, see [.NET Standard versions](https://dotnet.microsoft.com/platform/dotnet-standard#versions). diff --git a/includes/net-standard-1.5.md b/includes/net-standard-1.5.md index 2fae7fa398f62..307733f4d435e 100644 --- a/includes/net-standard-1.5.md +++ b/includes/net-standard-1.5.md @@ -1,15 +1,15 @@ .NET Standard 1.5 has 13,355 of the 37,118 available APIs. -| .NET implementation | Version support | -|-----------------------------|------------------------------------------------------------| -| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0 | -| .NET Framework 1 | 4.6.1 2, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | -| Mono | 4.6, 5.4, 6.4 | -| Xamarin.iOS | 10.0, 10.14, 12.16 | -| Xamarin.Mac | 3.0, 3.8, 5.16 | -| Xamarin.Android | 7.0, 8.0, 10.0 | -| Universal Windows Platform | 10.0.16299, TBD | -| Unity | 2018.1 | +| .NET implementation | Version support | +|-----------------------------|------------------------------------------------------------------| +| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0 | +| .NET Framework 1 | 4.6.1 2, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | +| Mono | 4.6, 5.4, 6.4 | +| Xamarin.iOS | 10.0, 10.14, 12.16 | +| Xamarin.Mac | 3.0, 3.8, 5.16 | +| Xamarin.Android | 7.0, 8.0, 10.0 | +| Universal Windows Platform | 10.0.16299, TBD | +| Unity | 2018.1 | 1 The versions listed for .NET Framework apply to .NET Core 2.0 SDK and later versions of the tooling. Older versions used a different mapping for .NET Standard 1.5 and higher. You can [download tooling for .NET Core tools for Visual Studio 2015](https://github.com/dotnet/core/blob/main/release-notes/download-archives) if you cannot upgrade to Visual Studio 2017 or a later version. diff --git a/includes/net-standard-1.6.md b/includes/net-standard-1.6.md index 31bc52103602a..caa087d9d9331 100644 --- a/includes/net-standard-1.6.md +++ b/includes/net-standard-1.6.md @@ -1,15 +1,15 @@ .NET Standard 1.6 has 13,501 of the 37,118 available APIs. -| .NET implementation | Version support | -|-----------------------------|------------------------------------------------------------| -| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0 | -| .NET Framework 1 | 4.6.1 2, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | -| Mono | 4.6, 5.4, 6.4 | -| Xamarin.iOS | 10.0, 10.14, 12.16 | -| Xamarin.Mac | 3.0, 3.8, 5.16 | -| Xamarin.Android | 7.0, 8.0, 10.0 | -| Universal Windows Platform | 10.0.16299, TBD | -| Unity | 2018.1 | +| .NET implementation | Version support | +|-----------------------------|------------------------------------------------------------------| +| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0 | +| .NET Framework 1 | 4.6.1 2, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | +| Mono | 4.6, 5.4, 6.4 | +| Xamarin.iOS | 10.0, 10.14, 12.16 | +| Xamarin.Mac | 3.0, 3.8, 5.16 | +| Xamarin.Android | 7.0, 8.0, 10.0 | +| Universal Windows Platform | 10.0.16299, TBD | +| Unity | 2018.1 | 1 The versions listed for .NET Framework apply to .NET Core 2.0 SDK and later versions of the tooling. Older versions used a different mapping for .NET Standard 1.5 and higher. You can [download tooling for .NET Core tools for Visual Studio 2015](https://github.com/dotnet/core/blob/main/release-notes/download-archives) if you cannot upgrade to Visual Studio 2017 or a later version. diff --git a/includes/net-standard-2.0.md b/includes/net-standard-2.0.md index 948c5bfbb6b1b..18ba3724ef4df 100644 --- a/includes/net-standard-2.0.md +++ b/includes/net-standard-2.0.md @@ -2,7 +2,7 @@ | .NET implementation | Version support | | --------------------------- | -------------------------------------------------------- | -| .NET and .NET Core | 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0 | +| .NET and .NET Core | 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0 | | .NET Framework 1 | 4.6.1 2, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | | Mono | 5.4, 6.4 | | Xamarin.iOS | 10.14, 12.16 | diff --git a/includes/net-standard-2.1.md b/includes/net-standard-2.1.md index 8cd9cf4668ee6..8770325702261 100644 --- a/includes/net-standard-2.1.md +++ b/includes/net-standard-2.1.md @@ -1,15 +1,15 @@ .NET Standard 2.1 has 37,118 of the 37,118 available APIs. -| .NET implementation | Version support | -|-----------------------------|-----------------------------------| -| .NET and .NET Core | 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0 | -| .NET Framework 1 | N/A2 | -| Mono | 6.4 | -| Xamarin.iOS | 12.16 | -| Xamarin.Mac | 5.16 | -| Xamarin.Android | 10.0 | -| Universal Windows Platform | N/A3 | -| Unity | 2021.2 | +| .NET implementation | Version support | +|-----------------------------|-----------------------------------------| +| .NET and .NET Core | 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0 | +| .NET Framework 1 | N/A2 | +| Mono | 6.4 | +| Xamarin.iOS | 12.16 | +| Xamarin.Mac | 5.16 | +| Xamarin.Android | 10.0 | +| Universal Windows Platform | N/A3 | +| Unity | 2021.2 | 1 The versions listed for .NET Framework apply to .NET Core 2.0 SDK and later versions of the tooling. Older versions used a different mapping for .NET Standard 1.5 and higher. You can [download tooling for .NET Core tools for Visual Studio 2015](https://github.com/dotnet/core/blob/main/release-notes/download-archives) if you cannot upgrade to Visual Studio 2017 or a later version. diff --git a/includes/preprocessor-symbols.md b/includes/preprocessor-symbols.md index 7df83cb2fac70..e7f482d3fe038 100644 --- a/includes/preprocessor-symbols.md +++ b/includes/preprocessor-symbols.md @@ -5,7 +5,7 @@ ms.custom: "updateeachrelease" | ------------------| ------- | ------------------------------------------------ | -------------------------------------------------------------------- | | .NET Framework | `NETFRAMEWORK`, `NET481`, `NET48`, `NET472`, `NET471`, `NET47`, `NET462`, `NET461`, `NET46`, `NET452`, `NET451`, `NET45`, `NET40`, `NET35`, `NET20` | `NET48_OR_GREATER`, `NET472_OR_GREATER`, `NET471_OR_GREATER`, `NET47_OR_GREATER`, `NET462_OR_GREATER`, `NET461_OR_GREATER`, `NET46_OR_GREATER`, `NET452_OR_GREATER`, `NET451_OR_GREATER`, `NET45_OR_GREATER`, `NET40_OR_GREATER`, `NET35_OR_GREATER`, `NET20_OR_GREATER` | | | .NET Standard | `NETSTANDARD`, `NETSTANDARD2_1`, `NETSTANDARD2_0`, `NETSTANDARD1_6`, `NETSTANDARD1_5`, `NETSTANDARD1_4`, `NETSTANDARD1_3`, `NETSTANDARD1_2`, `NETSTANDARD1_1`, `NETSTANDARD1_0` | `NETSTANDARD2_1_OR_GREATER`, `NETSTANDARD2_0_OR_GREATER`, `NETSTANDARD1_6_OR_GREATER`, `NETSTANDARD1_5_OR_GREATER`, `NETSTANDARD1_4_OR_GREATER`, `NETSTANDARD1_3_OR_GREATER`, `NETSTANDARD1_2_OR_GREATER`, `NETSTANDARD1_1_OR_GREATER`, `NETSTANDARD1_0_OR_GREATER` | | -| .NET 5+ (and .NET Core) | `NET`, `NET9_0`, `NET8_0`, `NET7_0`, `NET6_0`, `NET5_0`, `NETCOREAPP`, `NETCOREAPP3_1`, `NETCOREAPP3_0`, `NETCOREAPP2_2`, `NETCOREAPP2_1`, `NETCOREAPP2_0`, `NETCOREAPP1_1`, `NETCOREAPP1_0` | `NET9_0_OR_GREATER`, `NET8_0_OR_GREATER`, `NET7_0_OR_GREATER`, `NET6_0_OR_GREATER`, `NET5_0_OR_GREATER`, `NETCOREAPP3_1_OR_GREATER`, `NETCOREAPP3_0_OR_GREATER`, `NETCOREAPP2_2_OR_GREATER`, `NETCOREAPP2_1_OR_GREATER`, `NETCOREAPP2_0_OR_GREATER`, `NETCOREAPP1_1_OR_GREATER`, `NETCOREAPP1_0_OR_GREATER` | `ANDROID`, `BROWSER`, `IOS`, `MACCATALYST`, `MACOS`, `TVOS`, `WINDOWS`,
`[OS][version]` (for example `IOS15_1`),
`[OS][version]_OR_GREATER` (for example `IOS15_1_OR_GREATER`) | +| .NET 5+ (and .NET Core) | `NET`, `NET10_0`, `NET9_0`, `NET8_0`, `NET7_0`, `NET6_0`, `NET5_0`, `NETCOREAPP`, `NETCOREAPP3_1`, `NETCOREAPP3_0`, `NETCOREAPP2_2`, `NETCOREAPP2_1`, `NETCOREAPP2_0`, `NETCOREAPP1_1`, `NETCOREAPP1_0` | `NET10_0_OR_GREATER`, `NET9_0_OR_GREATER`, `NET8_0_OR_GREATER`, `NET7_0_OR_GREATER`, `NET6_0_OR_GREATER`, `NET5_0_OR_GREATER`, `NETCOREAPP3_1_OR_GREATER`, `NETCOREAPP3_0_OR_GREATER`, `NETCOREAPP2_2_OR_GREATER`, `NETCOREAPP2_1_OR_GREATER`, `NETCOREAPP2_0_OR_GREATER`, `NETCOREAPP1_1_OR_GREATER`, `NETCOREAPP1_0_OR_GREATER` | `ANDROID`, `BROWSER`, `IOS`, `MACCATALYST`, `MACOS`, `TVOS`, `WINDOWS`,
`[OS][version]` (for example `IOS15_1`),
`[OS][version]_OR_GREATER` (for example `IOS15_1_OR_GREATER`) | > [!NOTE] > From eea34f69e6e63748a8888e4c17bfef8a719e2efe Mon Sep 17 00:00:00 2001 From: Meaghan Osagie Date: Fri, 7 Nov 2025 10:42:11 -0800 Subject: [PATCH 2/9] remove LTS from out of support versions --- docs/core/install/linux-scripted-manual.md | 20 ++++++++++---------- docs/core/install/linux-snap-sdk.md | 6 +++--- 2 files changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/core/install/linux-scripted-manual.md b/docs/core/install/linux-scripted-manual.md index cabac57fe6b87..00bf687eab440 100644 --- a/docs/core/install/linux-scripted-manual.md +++ b/docs/core/install/linux-scripted-manual.md @@ -21,16 +21,16 @@ The following table lists the support status of each version of .NET (and .NET C | ✔️ Supported | ❌ Out of support | |---------------|-------------------| -| 10 (STS) | 7 | -| 9 (STS) | 6 (LTS) | -| 8 (LTS) | 5 | -| | 3.1 | -| | 3.0 | -| | 2.2 | -| | 2.1 | -| | 2.0 | -| | 1.1 | -| | 1.0 | +| 10 (STS) | 7 | +| 9 (STS) | 6 | +| 8 (LTS) | 5 | +| | 3.1 | +| | 3.0 | +| | 2.2 | +| | 2.1 | +| | 2.0 | +| | 1.1 | +| | 1.0 | ## Dependencies diff --git a/docs/core/install/linux-snap-sdk.md b/docs/core/install/linux-snap-sdk.md index 395048a04099d..5cc175cdb5552 100644 --- a/docs/core/install/linux-snap-sdk.md +++ b/docs/core/install/linux-snap-sdk.md @@ -60,9 +60,9 @@ The following table lists the package channels you can install: |--------------|---------------------------------| | 10 (STS) | *Not yet available | | 9 (STS) | *Not yet available | -| 8 (LTS) | `8.0/stable`
`lts/stable` | -| 7 (STS) | `7.0/stable` (out of support) | -| 6 (LTS) | `6.0/stable` (out of support) | +| 8 (LTS) | `8.0/stable` (out of support) | +| 7 | `7.0/stable` (out of support) | +| 6 | `6.0/stable` (out of support) | | 5 | `5.0/stable` (out of support) | | 3.1 | `3.1/stable` (out of support) | | 2.1 | `2.1/stable` (out of support) | From cf1c7605a5c60ea227a87dfc6c0ecab0fcd1cfad Mon Sep 17 00:00:00 2001 From: "Meaghan Osagie (Lewis)" Date: Fri, 7 Nov 2025 11:06:16 -0800 Subject: [PATCH 3/9] Update docs/core/install/linux-ubuntu-decision.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/core/install/linux-ubuntu-decision.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/core/install/linux-ubuntu-decision.md b/docs/core/install/linux-ubuntu-decision.md index 9fa05c05d5a7a..4a7a969ed76b8 100644 --- a/docs/core/install/linux-ubuntu-decision.md +++ b/docs/core/install/linux-ubuntu-decision.md @@ -240,8 +240,8 @@ The following sections describe how to manage .NET through the package manager. Install .NET through the package manager with the `sudo apt install ` command. Replace `` with the name of the .NET package you want to install. For example, to install .NET SDK 10.0, use the command `sudo apt install dotnet-sdk-10.0`. The following table lists the currently supported .NET packages (which [might vary by your Ubuntu version](#supported-distributions)): -| Product | Type | Package | -|------------|--------------|---------|--------------------------| +| Product | Type | Package | +|------------|--------------|--------------------------| | **10.0** | ASP.NET Core | Runtime | `aspnetcore-runtime-10.0`| | **10.0** | .NET | Runtime | `dotnet-runtime-10.0` | | **10.0** | .NET | SDK | `dotnet-sdk-10.0` | From 630d14127d7b90dc6f93ce282fdd915067cbec0e Mon Sep 17 00:00:00 2001 From: Meaghan Osagie Date: Fri, 7 Nov 2025 11:10:21 -0800 Subject: [PATCH 4/9] edits --- docs/core/tools/dotnet-new-sdk-templates.md | 6 +++--- includes/net-standard-1.2.md | 20 ++++++++++---------- includes/preprocessor-symbols.md | 2 +- 3 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/core/tools/dotnet-new-sdk-templates.md b/docs/core/tools/dotnet-new-sdk-templates.md index 5b060f1ca27d3..f2db5a218726b 100644 --- a/docs/core/tools/dotnet-new-sdk-templates.md +++ b/docs/core/tools/dotnet-new-sdk-templates.md @@ -25,9 +25,9 @@ The following table shows the templates that come preinstalled with the .NET SDK | Templates | Short name | Language | Tags | Introduced | |-----------------------------|-----------------------------------|----------|-------------------------|------------| -| ASP.NET Core API | [`webapiaot`](#webapiaot) | [C#] | Web/Web API/API/Service | 10.0 | -| ASP.NET Core API controller | [`apicontroller`](#apicontroller) | [C#] | Web/ASP.NET | 10.0 | -| ASP.NET Core Empty | [`web`](#web) | [C#], F# | Web/Empty | 1.0 | +| ASP.NET Core API | [`webapiaot`](#webapiaot) | [C#] | Web/Web API/API/Service | 8.0 | +| ASP.NET Core API controller | [`apicontroller`](#apicontroller) | [C#] | Web/ASP.NET | 8.0 | +| ASP.NET Core Empty | [`web`](#web) | [C#], F# | Web/Empty | 8.0 | | ASP.NET Core Web API | [`webapi`](#webapi) | [C#], F# | Web/Web API/API/Service/WebAPI | 1.0 | | ASP.NET Core Web App (Model-View-Controller) | [`mvc`](#web-options) | [C#], F# | Web/MVC | 1.0 | | ASP.NET Core Web App | [`webapp, razor`](#web-options) | [C#] | Web/MVC/Razor Pages | 2.2, 2.0 | diff --git a/includes/net-standard-1.2.md b/includes/net-standard-1.2.md index 73f8f6a352fe2..203cd0c7fe3df 100644 --- a/includes/net-standard-1.2.md +++ b/includes/net-standard-1.2.md @@ -1,15 +1,15 @@ .NET Standard 1.2 has 10,285 of the 37,118 available APIs. -| .NET implementation | Version support | -| -------------------------- | ----------------------------------------------------------------- | -| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0 , 10.0 | -| .NET Framework | 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | -| Mono | 4.6, 5.4, 6.4 | -| Xamarin.iOS | 10.0, 10.14, 12.16 | -| Xamarin.Mac | 3.0, 3.8, 5.16 | -| Xamarin.Android | 7.0, 8.0, 10.0 | -| Universal Windows Platform | 8.1, 10.0, 10.0.16299, TBD | -| Unity | 2018.1 | +| .NET implementation | Version support | +| -------------------------- | -----------------------------------------------------------------| +| .NET and .NET Core | 1.0, 1.1, 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0 | +| .NET Framework | 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 | +| Mono | 4.6, 5.4, 6.4 | +| Xamarin.iOS | 10.0, 10.14, 12.16 | +| Xamarin.Mac | 3.0, 3.8, 5.16 | +| Xamarin.Android | 7.0, 8.0, 10.0 | +| Universal Windows Platform | 8.1, 10.0, 10.0.16299, TBD | +| Unity | 2018.1 | For more information, see [.NET Standard 1.2][1.2]. For an interactive table, see [.NET Standard versions](https://dotnet.microsoft.com/platform/dotnet-standard#versions). diff --git a/includes/preprocessor-symbols.md b/includes/preprocessor-symbols.md index e7f482d3fe038..f71658739a3ff 100644 --- a/includes/preprocessor-symbols.md +++ b/includes/preprocessor-symbols.md @@ -5,7 +5,7 @@ ms.custom: "updateeachrelease" | ------------------| ------- | ------------------------------------------------ | -------------------------------------------------------------------- | | .NET Framework | `NETFRAMEWORK`, `NET481`, `NET48`, `NET472`, `NET471`, `NET47`, `NET462`, `NET461`, `NET46`, `NET452`, `NET451`, `NET45`, `NET40`, `NET35`, `NET20` | `NET48_OR_GREATER`, `NET472_OR_GREATER`, `NET471_OR_GREATER`, `NET47_OR_GREATER`, `NET462_OR_GREATER`, `NET461_OR_GREATER`, `NET46_OR_GREATER`, `NET452_OR_GREATER`, `NET451_OR_GREATER`, `NET45_OR_GREATER`, `NET40_OR_GREATER`, `NET35_OR_GREATER`, `NET20_OR_GREATER` | | | .NET Standard | `NETSTANDARD`, `NETSTANDARD2_1`, `NETSTANDARD2_0`, `NETSTANDARD1_6`, `NETSTANDARD1_5`, `NETSTANDARD1_4`, `NETSTANDARD1_3`, `NETSTANDARD1_2`, `NETSTANDARD1_1`, `NETSTANDARD1_0` | `NETSTANDARD2_1_OR_GREATER`, `NETSTANDARD2_0_OR_GREATER`, `NETSTANDARD1_6_OR_GREATER`, `NETSTANDARD1_5_OR_GREATER`, `NETSTANDARD1_4_OR_GREATER`, `NETSTANDARD1_3_OR_GREATER`, `NETSTANDARD1_2_OR_GREATER`, `NETSTANDARD1_1_OR_GREATER`, `NETSTANDARD1_0_OR_GREATER` | | -| .NET 5+ (and .NET Core) | `NET`, `NET10_0`, `NET9_0`, `NET8_0`, `NET7_0`, `NET6_0`, `NET5_0`, `NETCOREAPP`, `NETCOREAPP3_1`, `NETCOREAPP3_0`, `NETCOREAPP2_2`, `NETCOREAPP2_1`, `NETCOREAPP2_0`, `NETCOREAPP1_1`, `NETCOREAPP1_0` | `NET10_0_OR_GREATER`, `NET9_0_OR_GREATER`, `NET8_0_OR_GREATER`, `NET7_0_OR_GREATER`, `NET6_0_OR_GREATER`, `NET5_0_OR_GREATER`, `NETCOREAPP3_1_OR_GREATER`, `NETCOREAPP3_0_OR_GREATER`, `NETCOREAPP2_2_OR_GREATER`, `NETCOREAPP2_1_OR_GREATER`, `NETCOREAPP2_0_OR_GREATER`, `NETCOREAPP1_1_OR_GREATER`, `NETCOREAPP1_0_OR_GREATER` | `ANDROID`, `BROWSER`, `IOS`, `MACCATALYST`, `MACOS`, `TVOS`, `WINDOWS`,
`[OS][version]` (for example `IOS15_1`),
`[OS][version]_OR_GREATER` (for example `IOS15_1_OR_GREATER`) | +| .NET 5+ (and .NET Core) | `NET`, `NET10_0`, `NET9_0`, `NET8_0`, `NET7_0`, `NET6_0`, `NET5_0`, `NETCOREAPP`, `NETCOREAPP3_1`, `NETCOREAPP3_0`, `NETCOREAPP2_2`, `NETCOREAPP2_1`, `NETCOREAPP2_0`, `NETCOREAPP1_1`, `NETCOREAPP1_0` | `NET10_0_OR_GREATER`, `NET9_0_OR_GREATER`, `NET8_0_OR_GREATER`, `NET7_0_OR_GREATER`, `NET6_0_OR_GREATER`, `NET5_0_OR_GREATER`, `NETCOREAPP3_1_OR_GREATER`, `NETCOREAPP3_0_OR_GREATER`, `NETCOREAPP2_2_OR_GREATER`, `NETCOREAPP2_1_OR_GREATER`, `NETCOREAPP2_0_OR_GREATER`, `NETCOREAPP1_1_OR_GREATER`, `NETCOREAPP1_0_OR_GREATER` | `ANDROID`, `BROWSER`, `IOS`, `MACCATALYST`, `MACOS`, `TVOS`, `WINDOWS`,
`[OS][version]` (for example `IOS15_1`),
`[OS][version]_OR_GREATER` (for example `IOS15_1_OR_GREATER`) | > [!NOTE] > From bfcf55d2b959e588a305f9894534702b67397ace Mon Sep 17 00:00:00 2001 From: Meaghan Osagie Date: Fri, 7 Nov 2025 11:13:26 -0800 Subject: [PATCH 5/9] fix table format --- docs/core/install/linux-ubuntu-decision.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/core/install/linux-ubuntu-decision.md b/docs/core/install/linux-ubuntu-decision.md index 4a7a969ed76b8..b0c66ab8ebd59 100644 --- a/docs/core/install/linux-ubuntu-decision.md +++ b/docs/core/install/linux-ubuntu-decision.md @@ -240,8 +240,8 @@ The following sections describe how to manage .NET through the package manager. Install .NET through the package manager with the `sudo apt install ` command. Replace `` with the name of the .NET package you want to install. For example, to install .NET SDK 10.0, use the command `sudo apt install dotnet-sdk-10.0`. The following table lists the currently supported .NET packages (which [might vary by your Ubuntu version](#supported-distributions)): -| Product | Type | Package | -|------------|--------------|--------------------------| +| | Product | Type | Package | +|------------|--------------|---------|--------------------------| | **10.0** | ASP.NET Core | Runtime | `aspnetcore-runtime-10.0`| | **10.0** | .NET | Runtime | `dotnet-runtime-10.0` | | **10.0** | .NET | SDK | `dotnet-sdk-10.0` | From 24ddb0768c93d86e97c0e2c618f3185b9dfaf500 Mon Sep 17 00:00:00 2001 From: Meaghan Osagie Date: Fri, 7 Nov 2025 11:21:39 -0800 Subject: [PATCH 6/9] clarify .NET 10 as LTS --- docs/core/install/includes/supported-versions.md | 2 +- docs/core/install/linux-scripted-manual.md | 2 +- docs/core/install/linux-snap-sdk.md | 2 +- docs/core/versions/index.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/core/install/includes/supported-versions.md b/docs/core/install/includes/supported-versions.md index a725a81ce4514..fd2e78e8cdaa5 100644 --- a/docs/core/install/includes/supported-versions.md +++ b/docs/core/install/includes/supported-versions.md @@ -9,7 +9,7 @@ Microsoft publishes .NET under two different support policies, Long Term Support The versions of .NET that are currently supported by Microsoft are: -- 10.0 (STS)—Support ends **November 14, 2028**. +- 10.0 (LTS)—Support ends **November 14, 2028**. - 9.0 (STS)—Support ends **November 10, 2026**. - 8.0 (LTS)—Support ends **November 10, 2026**. diff --git a/docs/core/install/linux-scripted-manual.md b/docs/core/install/linux-scripted-manual.md index 00bf687eab440..3760bbc10b6df 100644 --- a/docs/core/install/linux-scripted-manual.md +++ b/docs/core/install/linux-scripted-manual.md @@ -21,7 +21,7 @@ The following table lists the support status of each version of .NET (and .NET C | ✔️ Supported | ❌ Out of support | |---------------|-------------------| -| 10 (STS) | 7 | +| 10 (LTS) | 7 | | 9 (STS) | 6 | | 8 (LTS) | 5 | | | 3.1 | diff --git a/docs/core/install/linux-snap-sdk.md b/docs/core/install/linux-snap-sdk.md index 5cc175cdb5552..3316000608d01 100644 --- a/docs/core/install/linux-snap-sdk.md +++ b/docs/core/install/linux-snap-sdk.md @@ -58,7 +58,7 @@ The following table lists the package channels you can install: | .NET version | Snap package channel | |--------------|---------------------------------| -| 10 (STS) | *Not yet available | +| 10 (LTS) | *Not yet available | | 9 (STS) | *Not yet available | | 8 (LTS) | `8.0/stable` (out of support) | | 7 | `7.0/stable` (out of support) | diff --git a/docs/core/versions/index.md b/docs/core/versions/index.md index 64511f59c8ac6..09aa7cd3d23b4 100644 --- a/docs/core/versions/index.md +++ b/docs/core/versions/index.md @@ -60,7 +60,7 @@ The optional `PRERELEASE` and `BUILDNUMBER` parts are never part of supported re - API introduced breaking changes. There's a high bar to accepting breaking changes. - A newer `MAJOR` version of an existing dependency is adopted. - Major releases happen once a year, even-numbered versions are long-term supported (LTS) releases. The first LTS release using this versioning scheme is .NET 6. The latest non-LTS version is .NET 10. + Major releases happen once a year, even-numbered versions are long-term supported (LTS) releases. The first LTS release using this versioning scheme is .NET 6. The latest non-LTS version is .NET 9. - `MINOR` is incremented when: From 3689227f329ba90acc6fbcc1b97d4935e8b8dc18 Mon Sep 17 00:00:00 2001 From: Meaghan Osagie Date: Fri, 7 Nov 2025 11:55:27 -0800 Subject: [PATCH 7/9] revert changes to target frameworks --- docs/standard/frameworks.md | 13 +------------ 1 file changed, 1 insertion(+), 12 deletions(-) diff --git a/docs/standard/frameworks.md b/docs/standard/frameworks.md index 7519621e61e91..210d067106a5f 100644 --- a/docs/standard/frameworks.md +++ b/docs/standard/frameworks.md @@ -1,7 +1,7 @@ --- title: Target frameworks in SDK-style projects - .NET description: Learn about target frameworks for .NET apps and libraries. -ms.date: 11/07/2025 +ms.date: 04/07/2025 ms.service: dotnet ms.custom: updateeachrelease ms.subservice: standard-library @@ -26,7 +26,6 @@ The following table defines the most common target frameworks, how they're refer | Target framework | Latest
stable version | Target framework moniker (TFM) | Implemented
.NET Standard version | |:----------------:|:---------------------------:|:------------------------------:|:---------------------------------------:| -| .NET 10 | 10 | net10.0 | 2.1 | | .NET 9 | 9 | net9.0 | 2.1 | | .NET 8 | 8 | net8.0 | 2.1 | | .NET Standard | 2.1 | netstandard2.1 | N/A | @@ -96,15 +95,6 @@ The following table shows the compatibility of the .NET 5+ TFMs. | `net9.0-tizen` | (Subsequent version of `net8.0-tizen`) | | `net9.0-tvos` | (Subsequent version of `net8.0-tvos`) | | `net9.0-windows` | (Subsequent version of `net8.0-windows`) | -| `net10.0` | (Subsequent version of `net9.0`) | -| `net10.0-android` | (Subsequent version of `net9.0-android`) | -| `net10.0-browser` | (Subsequent version of `net9.0-browser`) | -| `net10.0-ios` | (Subsequent version of `net9.0-ios`) | -| `net10.0-maccatalyst`| (Subsequent version of `net9.0-maccatalyst`) | -| `net10.0-macos` | (Subsequent version of `net9.0-macos`) | -| `net10.0-tizen` | (Subsequent version of `net9.0-tizen`) | -| `net10.0-tvos` | (Subsequent version of `net9.0-tvos`) | -| `net10.0-windows` | (Subsequent version of `net9.0-windows`) | To make your app portable across different platforms but still have access to OS-specific APIs, you can target multiple OS-specific TFMs and add platform guards around OS-specific API calls using `#if` preprocessor directives. For a list of the available symbols, see [Preprocessor symbols](#preprocessor-symbols). @@ -130,7 +120,6 @@ The following table shows the *default* target platform version (TPV) for each . |--------------|--------:|-----:|-------------:|------:|-----:|------:|--------:| | .NET 8 | 34.0 | 17.2 | 17.2 | 14.2 | 17.1 | 10.0 | 7.0 | | .NET 9 | 35.0 | 18.0 | 18.0 | 15.0 | | 10.0 | 7.0 | -| .NET 10 | 36.0 | 18.0 | 18.0 | 26.0 | | 10.0 | 7.0 | Starting in .NET 9, when service releases introduce support for a later TPV (which will always have the same *major* version number as when the .NET version was initially released), the earliest supported TPV for that .NET version will remain supported. For example, for .NET 9, the earliest supported iOS version, 18.0, will remain supported, even when a service release adds support for the latest iOS 18.x version. **If you need to use the earliest bindings for a .NET release, use a specific OS version number in your TFM.** From 537ea6f39e5e4be4a46b67e2a3a24dd09667ce94 Mon Sep 17 00:00:00 2001 From: Meaghan Osagie Date: Fri, 7 Nov 2025 11:56:32 -0800 Subject: [PATCH 8/9] change back template version --- docs/core/tools/dotnet-new-sdk-templates.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/tools/dotnet-new-sdk-templates.md b/docs/core/tools/dotnet-new-sdk-templates.md index f2db5a218726b..32bd48a574161 100644 --- a/docs/core/tools/dotnet-new-sdk-templates.md +++ b/docs/core/tools/dotnet-new-sdk-templates.md @@ -27,7 +27,7 @@ The following table shows the templates that come preinstalled with the .NET SDK |-----------------------------|-----------------------------------|----------|-------------------------|------------| | ASP.NET Core API | [`webapiaot`](#webapiaot) | [C#] | Web/Web API/API/Service | 8.0 | | ASP.NET Core API controller | [`apicontroller`](#apicontroller) | [C#] | Web/ASP.NET | 8.0 | -| ASP.NET Core Empty | [`web`](#web) | [C#], F# | Web/Empty | 8.0 | +| ASP.NET Core Empty | [`web`](#web) | [C#], F# | Web/Empty | 1.0 | | ASP.NET Core Web API | [`webapi`](#webapi) | [C#], F# | Web/Web API/API/Service/WebAPI | 1.0 | | ASP.NET Core Web App (Model-View-Controller) | [`mvc`](#web-options) | [C#], F# | Web/MVC | 1.0 | | ASP.NET Core Web App | [`webapp, razor`](#web-options) | [C#] | Web/MVC/Razor Pages | 2.2, 2.0 | From 1edca1cb4c0e686986e8c3dd7ef1ca360748d227 Mon Sep 17 00:00:00 2001 From: Meaghan Osagie Date: Fri, 7 Nov 2025 12:04:34 -0800 Subject: [PATCH 9/9] add lts/stable back to .NET SDK 8 snap channel --- docs/core/install/linux-snap-sdk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/install/linux-snap-sdk.md b/docs/core/install/linux-snap-sdk.md index 3316000608d01..6f641523d4a39 100644 --- a/docs/core/install/linux-snap-sdk.md +++ b/docs/core/install/linux-snap-sdk.md @@ -60,7 +60,7 @@ The following table lists the package channels you can install: |--------------|---------------------------------| | 10 (LTS) | *Not yet available | | 9 (STS) | *Not yet available | -| 8 (LTS) | `8.0/stable` (out of support) | +| 8 (LTS) | `8.0/stable`
`lts/stable` | | 7 | `7.0/stable` (out of support) | | 6 | `6.0/stable` (out of support) | | 5 | `5.0/stable` (out of support) |