Skip to content
6 changes: 3 additions & 3 deletions api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
34 changes: 17 additions & 17 deletions docs/core/install/how-to-detect-installed-versions.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---
Expand All @@ -29,35 +29,32 @@ 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

::: 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

::: 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
Expand All @@ -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
Expand All @@ -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
Expand All @@ -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
Expand Down
3 changes: 2 additions & 1 deletion docs/core/install/includes/supported-versions.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,15 @@
---
author: adegeo
ms.author: adegeo
ms.date: 08/26/2025
ms.date: 11/07/2025
ms.topic: include
---

Microsoft publishes .NET under two different support policies, Long Term Support (LTS) and Standard Term Support (STS). The quality of all releases is the same. The only difference is the length of support. LTS releases get free support and patches for three years. STS releases get free support and patches for two years. For more information, see [.NET Support Policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core).

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**.

Expand Down
25 changes: 13 additions & 12 deletions docs/core/install/linux-scripted-manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---

Expand All @@ -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

Expand Down Expand Up @@ -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)
Expand Down
7 changes: 4 additions & 3 deletions docs/core/install/linux-snap-sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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`<br>`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) |
Expand Down
2 changes: 1 addition & 1 deletion docs/core/project-sdk/msbuild-props.md
Original file line number Diff line number Diff line change
@@ -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
---
Expand Down
21 changes: 11 additions & 10 deletions docs/core/tools/dotnet-new-sdk-templates.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`

Expand All @@ -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 |
Expand Down Expand Up @@ -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.

Expand Down Expand Up @@ -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.

Expand All @@ -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.

Expand Down Expand Up @@ -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.

Expand Down Expand Up @@ -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.

Expand Down Expand Up @@ -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` |

Expand Down Expand Up @@ -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.

Expand Down Expand Up @@ -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.

Expand Down
2 changes: 1 addition & 1 deletion docs/core/versions/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions docs/fundamentals/implementations.md
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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:

Expand Down
4 changes: 2 additions & 2 deletions docs/standard/choosing-core-framework-server.md
Original file line number Diff line number Diff line change
@@ -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 |
|----------------|-----------------------------------------------------|
Expand Down
6 changes: 3 additions & 3 deletions docs/welcome.md
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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)

Expand Down
2 changes: 1 addition & 1 deletion includes/net-standard-1.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -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, 10.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 |
Expand Down
Loading