-
Notifications
You must be signed in to change notification settings - Fork 6.1k
Add information about changes to Win11 and 3.5 #51430
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
adegeo
wants to merge
10
commits into
main
Choose a base branch
from
adegeo/win11.framework/51395
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
Show all changes
10 commits
Select commit
Hold shift + click to select a range
40ec140
Add information about changes to Win11 and 3.5
adegeo 6ca124b
Fix build errors
adegeo a15ad6d
Adjust headers a little bit
adegeo edd6946
Restructured a bit and added more info to win 11 article
adegeo c368988
Remove the FAQ link from the include
adegeo cdd4dff
Fix links
adegeo f56a2b4
Fix other link
adegeo f3b413d
Apply suggestions from code review
adegeo 9684106
Port "how to determine" to include
adegeo 39e39b7
Merge branch 'main' of github.adegeo:dotnet/docs into adegeo/win11.fr…
adegeo File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,75 @@ | ||
| ### YamlMime:FAQ | ||
| metadata: | ||
| title: .NET Framework 3.5 on Windows 11 FAQ | ||
| description: "This article answers frequently asked questions about .NET Framework 3.5 on Windows 11." | ||
| titleSuffix: "" | ||
| ms.topic: faq | ||
| ms.date: 02/02/2026 | ||
| ai-usage: ai-assisted | ||
|
|
||
| title: .NET Framework 3.5 on Windows 11 FAQ | ||
| summary: | | ||
| This article answers frequently asked questions about .NET Framework 3.5 on Windows 11. For more information, see [Install .NET Framework 3.5 on Windows 11](dotnet-35-windows-11.md). | ||
|
|
||
| [!INCLUDE [dotnet-35-installer](includes/dotnet-35-installer.md)] | ||
|
|
||
| sections: | ||
| - name: Availability and lifecycle | ||
| questions: | ||
| - question: Is .NET Framework 3.5 included in Windows 11? | ||
| answer: | | ||
| Your Windows 11 version determines availability: | ||
|
|
||
| - Windows 11 Insider Preview Build 27965 and later versions. | ||
|
|
||
| No. Windows doesn't include .NET Framework 3.5 as a built-in or optional component. | ||
|
|
||
| - Windows 11 25H2 and earlier versions. | ||
|
|
||
| Yes. Windows includes .NET Framework 3.5 as a built-in optional component. Enable it through Windows Features on Demand. | ||
|
|
||
| - question: How long is the .NET Framework 3.5 standalone installer supported? | ||
| answer: Support ends January 9, 2029, according to the official [Microsoft .NET Framework lifecycle policy](/lifecycle/products/microsoft-net-framework). | ||
|
|
||
| - question: When I upgrade to a newer version of Windows, is .NET Framework 3.5 included or persisted? | ||
| answer: No. When you upgrade Windows to the next release, reinstall .NET Framework 3.5. | ||
|
|
||
| - name: Installation and deployment | ||
| questions: | ||
| - question: How do I get .NET Framework 3.5 if my application requires it? | ||
| answer: Use the standalone installer. For more details, including a link to the installer, see [Announcing Windows 11 Insider Preview Build 27965 (Canary Channel)](https://blogs.windows.com/windows-insider/2025/10/08/announcing-windows-11-insider-preview-build-27965-canary-channel/). | ||
|
|
||
| - question: Are silent installs supported for the new .NET Framework 3.5 standalone installer? | ||
| answer: Yes. Use `/q` and `/quiet` command-line options for unattended deployment. | ||
|
|
||
| - question: Can I apply .NET Framework 3.5 to an offline Windows image? | ||
| answer: No. Offline installation and servicing isn't supported because .NET Framework 3.5 is no longer an optional Windows Feature on Demand component. DISM and other tools that customize offline Windows deployment images can't manage .NET Framework 3.5. Use **online servicing** to modify a Windows installation. For more information, see [Modify a Windows image](/windows-hardware/manufacture/desktop/modify-an-image?view=windows-11). | ||
|
|
||
| - name: Migration and support | ||
| questions: | ||
| - question: What is the recommended migration path? | ||
| answer: | | ||
| Update your application from .NET Framework to .NET. If you can't move to .NET, update your application to .NET Framework 4.8.1. For more information, see [Microsoft .NET Framework lifecycle policy](/lifecycle/products/microsoft-net-framework). | ||
|
|
||
| - question: Where can enterprises and ISVs get additional help with compatibility? | ||
| answer: | | ||
| Use the [Microsoft FastTrack – App Assure](/microsoft-365/fasttrack/windows-365-and-app-assure#app-assure) program for personalized migration and compatibility assistance. | ||
|
|
||
| - name: Troubleshooting | ||
| questions: | ||
| - question: | | ||
| When I try to run a legacy .NET Framework 3.5 application or its installer, I see a "Program Compatibility Assistant" or a Microsoft .NET Framework runtime message box. Is this expected? | ||
| answer: | | ||
| Yes. Your application or its installer requires .NET Framework 3.5 to run. The message box links to this document. | ||
|
|
||
| - question: | | ||
| My .NET Framework 3.5 application displays an unclear message, like "runtime error" without further guidance when I don't have .NET 3.5 installed. Is this expected? | ||
| answer: | | ||
| Legacy applications might handle the missing dependency in various ways, including unclear messages. Use the mitigation guidance in this document or contact your software vendor for more information. | ||
|
|
||
| additionalContent: | | ||
| ## Related content | ||
|
|
||
| - [Install .NET Framework 3.5 on Windows 11](dotnet-35-windows-11.md) | ||
| - [Developers and .NET Framework 3.5](dotnet-35-windows.md#developers-and-net-framework-35) | ||
|
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,72 @@ | ||
| --- | ||
| title: Install .NET Framework 3.5 on Windows 11 | ||
| description: Learn how to install .NET Framework 3.5 on Windows 11. .NET Framework 3.5 can run apps that target .NET Framework 1.0 through 3.5. | ||
| ms.date: 02/02/2026 | ||
| ai-usage: ai-assisted | ||
| --- | ||
| # Install .NET Framework 3.5 on Windows 11 | ||
|
|
||
| .NET Framework 3.5 is supported on Windows 11. How you obtain .NET Framework 3.5 depends on which version of Windows 11 you're using. Use the following list to identify the installation method that's applicable to you: | ||
|
|
||
| - [Windows 11 25H2 and earlier versions.](dotnet-35-windows.md#install-net-framework-35-on-demand) | ||
| - [Windows 11 Insider Preview Build 27965 and later versions.](#windows-11-insider-preview-build-27965-and-later) | ||
|
|
||
| ## Windows 11 Insider Preview Build 27965 and later | ||
|
|
||
| [!INCLUDE [dotnet-35-installer](includes/dotnet-35-installer.md)] | ||
|
|
||
| For more information about this change to .NET Framework 3.5, see [.NET Framework 3.5 on Windows 11 FAQ](dotnet-35-windows-11-faq.yml). | ||
|
|
||
| ## .NET Framework 3.5 optional components | ||
|
|
||
| _Applies to **Windows 11 Insider Preview Build 27965 and later**_ | ||
|
|
||
| The following optional .NET Framework 3.5 components were previously available as Windows Features on Demand. Windows 11 Insider Preview Build 27965 removes these components: | ||
|
|
||
| - ASP.NET 3.5 | ||
| - .NET Extensibility 3.5 | ||
| - WCF HTTP Activation | ||
| - WCF non-HTTP Activation | ||
|
|
||
| ## How to enable ASP.NET 3.5 and WCF in IIS | ||
|
|
||
| Starting with Windows 11 Insider Preview Build 27965, ASP.NET 3.5 and WCF require additional registration to run in IIS. | ||
|
|
||
| Enable ASP.NET 3.5 on your device using the [`Enable-ASPNet35.ps1`](https://go.microsoft.com/fwlink/?linkid=2348600&clcid=0x409) PowerShell script. The script enables the functionality of the following optional components that have been removed from Windows: | ||
|
|
||
| - ASP.NET 3.5 | ||
| - .NET Extensibility 3.5 | ||
|
|
||
| > [!NOTE] | ||
| > The script only restores the functionality of these optional components so that applications that depend on them can continue working. The optional components are still missing from Windows 11 and tools like DISM won't detect these optional components as present after running the script. | ||
|
|
||
| ### Prerequisites | ||
|
|
||
| - Windows Insider Preview Build 27965 or later | ||
| - Windows PowerShell 5.1 | ||
| - .NET Framework 3.5 | ||
| - The Web Server (IIS) feature or role enabled, along with the **ISAPI Filters** and **ISAPI Extensions** optional components | ||
| - An administrative PowerShell command window | ||
|
|
||
| ### Run the script | ||
|
|
||
| 1. Download the [`Enable-ASPNet35.ps1`](https://go.microsoft.com/fwlink/?linkid=2348600&clcid=0x409) script to a local directory. | ||
| 1. Open a Windows PowerShell command window **as Administrator**. | ||
| 1. Change the execution policy to allow scripts downloaded from the Internet and signed by trusted publishers: | ||
|
|
||
| ```powershell | ||
| Set-ExecutionPolicy RemoteSigned | ||
| ``` | ||
|
|
||
| For more information about execution policy settings, see [Set-ExecutionPolicy](/powershell/module/microsoft.powershell.security/set-executionpolicy?view=powershell-5.1&preserve-view=true). | ||
|
|
||
| 1. Go to the directory where you downloaded the script. | ||
| 1. Run the script: | ||
|
|
||
| ```powershell | ||
| .\Enable-ASPNet35.ps1 | ||
| ``` | ||
|
|
||
| ## How to determine which version of Windows you're using | ||
|
|
||
| [!INCLUDE [dotnet-determine-windows-version](includes/dotnet-determine-windows-version.md)] | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| ms.author: adegeo | ||
| ms.date: 02/02/2026 | ||
| ms.topic: include | ||
| --- | ||
|
|
||
| > [!IMPORTANT] | ||
| > .NET Framework 3.5 was released in 2008. Before installing .NET Framework 3.5, try to find an updated version of your software that uses a new version of .NET Framework or .NET. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| ms.author: adegeo | ||
| ms.date: 02/02/2026 | ||
| ms.topic: include | ||
| ai-usage: ai-assisted | ||
| --- | ||
|
|
||
| Starting with Windows 11 Insider Preview Build 27965, .NET Framework 3.5 is no longer available as a Windows Features on Demand optional component. Install it using a standalone installer (also known as an offline installer). For more information, see [Announcing Windows 11 Insider Preview Build 27965 (Canary Channel)](https://blogs.windows.com/windows-insider/2025/10/08/announcing-windows-11-insider-preview-build-27965-canary-channel/). <!-- When updated in the future, note that these installers only work for this specific version of Windows 11. --> |
8 changes: 8 additions & 0 deletions
8
docs/framework/install/includes/dotnet-35-windows-11-caution-version.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| ms.author: adegeo | ||
| ms.date: 02/02/2026 | ||
| ms.topic: include | ||
| --- | ||
|
|
||
| > [!CAUTION] | ||
| > If you're using Windows 11 Insider Preview Build 27965 or later, see [Install .NET Framework 3.5 on Windows 11](../dotnet-35-windows-11.md). |
22 changes: 22 additions & 0 deletions
22
docs/framework/install/includes/dotnet-determine-windows-version.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,22 @@ | ||
| --- | ||
| ms.author: adegeo | ||
| ms.date: 02/02/2026 | ||
| ms.topic: include | ||
| --- | ||
|
|
||
| There are a few different ways you can find the version of Windows you're using: | ||
|
|
||
| - Try [this link (ms-settings:about)](ms-settings:about) which might open the Settings app. | ||
|
|
||
| 1. Scroll down to the **Windows specifications** section and find the **Version** field. | ||
|
|
||
| - Try using the start menu: | ||
|
|
||
| 1. Press the <kbd>Windows</kbd> key to open the **Start** menu. | ||
| 1. Type `Settings` to find the **Settings** app and open it. | ||
| 1. Scroll down to the **Windows specifications** section and find the **Version** field. | ||
|
|
||
| - Try running the `winver.exe` app: | ||
|
|
||
| 1. Press the <kbd>Windows+R</kbd> keyboard shortcut to open the **Run** dialog. | ||
| 1. Type `winver.exe` and press <kbd>Enter</kbd>. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.