Webforms To Blazor Upgrade

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:

> ⚠️ Unsupported target warning

> This scenario is designed and validated for migrating Web Forms projects to Blazor Server. You've asked to target {user's choice} instead.

>

> - There is no first-class support in this scenario for {user's choice}.

> - Expect reduced guidance, more manual decisions, and a higher chance of incomplete or incorrect transformations.

> - Assessment and high-level planning will still work, but execution will rely on general .NET knowledge rather than scenario-specific patterns.

>

> Do you want to proceed with {user's choice} anyway, or switch to the recommended Blazor Server target?

Workflow

Follow the dotnet-version-upgrade scenario skill for all stages (assessment, planning, execution).