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..fd2e78e8cdaa5 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 (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 3821ec806b325..3760bbc10b6df 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 (LTS) | 7 | +| 9 (STS) | 6 | +| 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..6f641523d4a39 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,10 +58,11 @@ The following table lists the package channels you can install: | .NET version | Snap package channel | |--------------|---------------------------------| +| 10 (LTS) | *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) | +| 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) | diff --git a/docs/core/install/linux-ubuntu-decision.md b/docs/core/install/linux-ubuntu-decision.md index 96d16b1b9b605..b0c66ab8ebd59 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..32bd48a574161 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 | 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 | 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..09aa7cd3d23b4 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 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/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..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 | -| .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..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`, `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] >