| name | webforms-to-blazor-upgrade |
| description | Upgrade ASP.NET Web Forms projects to modern .NET. Use when the user wants to upgrade, migrate, modernize, port, convert, or move Web Forms / WebForms / .aspx pages to any modern .NET. framework.
|
| metadata | {"discovery":"scenario","importance":"high","traits":"(.NET|CSharp|VisualBasic) & DotNetFramework & WebForms","scenarioTraitsSet":[".NET","DotNetFramework","WebForms"]} |
Web Forms to Blazor Upgrade Scenario
This scenario uses the dotnet-version-upgrade scenario workflow. The only differences are intent detection and target technology selection — this skill matches Web Forms upgrade requests specifically and always targets Blazor (Blazor Server) as the modernization destination.
Target Technology — Default Lock with Opt-Out
When Web Forms (.aspx, .ascx, .master, .asmx, System.Web.UI, <%@ Page %> directives, server controls, Global.asax, WebForm project type GUID {349C5851-65DF-11DA-9384-00065B846F21}) is detected, the default and strongly recommended upgrade target is Blazor Server. Blazor Server is the only target with full, validated support in this scenario.
When the user explicitly insists on a non-Blazor target
If — and only if — the user explicitly asks to target Razor Pages, ASP.NET Core MVC, Minimal APIs, Web API, or another non-Blazor framework, honor their choice rather than refusing. Before proceeding, deliver a clear warning once and get acknowledgment: