# Webforms To Blazor Upgrade

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

- Skill: `microsoft/webforms-to-blazor-upgrade` (Agent Skill)
- Install (CLI): `npx skillmds@latest add microsoft/webforms-to-blazor-upgrade`
- Raw SKILL.md: https://api.skillmd.com/api/skills/microsoft/webforms-to-blazor-upgrade/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Microsoft (https://skillmd.com/u/microsoft)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/microsoft/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).