ASP.NET WebForms转ASP.NET Core Razor Pages：页面转换实操求助

一、核心转换逻辑 #

• 拆分WebForms的aspx（UI层）与aspx.cs（后台逻辑），对应Razor Pages的cshtml（视图）和cshtml.cs（页面模型）
• 替换WebForms服务器控件为HTML原生控件或Razor Tag Helper
• 移除ViewState依赖，改用Razor Pages的模型绑定机制传递数据
• 将PostBack事件逻辑替换为HTTP POST请求处理方法

二、分步转换示例（基于典型WebForms页面） #

原WebForms实现示例 #

postback.aspx（UI）

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="postback.aspx.cs" Inherits="postback" %>

<!DOCTYPE html>
<html>
<head runat="server">
    <title>用户信息提交</title>
    <script src="Scripts/jquery-3.6.0.min.js"></script>
    <script>
        function validateForm() {
            var name = document.getElementById('txtName').value;
            if (name === '') {
                alert('请输入姓名');
                return false;
            }
            return true;
        }
    </script>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:Label ID="lblName" runat="server" Text="姓名："></asp:Label>
            <asp:TextBox ID="txtName" runat="server"></asp:TextBox>
            <asp:Button ID="btnSubmit" runat="server" Text="提交" OnClick="btnSubmit_Click" OnClientClick="return validateForm();" />
            <asp:Label ID="lblResult" runat="server" ForeColor="Green"></asp:Label>
        </div>
    </form>
</body>
</html>

postback.aspx.cs（后台）

using System;

public partial class postback : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (!IsPostBack)
        {
            lblResult.Text = "请输入信息提交";
        }
    }

    protected void btnSubmit_Click(object sender, EventArgs e)
    {
        if (!string.IsNullOrEmpty(txtName.Text))
        {
            lblResult.Text = $"欢迎你，{txtName.Text}！";
            // 业务逻辑：数据库写入等操作
        }
        else
        {
            lblResult.Text = "姓名不能为空";
        }
    }
}

转换后的Razor Pages实现 #

UserSubmit.cshtml（视图）

@page
@model UserSubmitModel
@{
    ViewData["Title"] = "用户信息提交";
}

<!DOCTYPE html>
<html>
<head>
    <title>@ViewData["Title"]</title>
    <script src="~/lib/jquery/dist/jquery.min.js"></script>
    <script>
        function validateForm() {
            var name = document.getElementById('Name').value;
            if (name === '') {
                alert('请输入姓名');
                return false;
            }
            return true;
        }
    </script>
</head>
<body>
    <form method="post" onsubmit="return validateForm();">
        <div>
            <label for="Name">姓名：</label>
            <input type="text" asp-for="Name" />
            <span asp-validation-for="Name" class="text-danger"></span>
            <button type="submit" asp-page-handler="Submit">提交</button>
            <p class="text-success">@Model.ResultMessage</p>
        </div>
    </form>
</body>
</html>

UserSubmit.cshtml.cs（页面模型）

using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;

namespace YourProjectNamespace.Pages
{
    public class UserSubmitModel : PageModel
    {
        [BindProperty]
        public string Name { get; set; }

        public string ResultMessage { get; set; }

        public void OnGet()
        {
            // 对应WebForms中!IsPostBack的首次加载逻辑
            ResultMessage = "请输入信息提交";
        }

        public IActionResult OnPostSubmit()
        {
            if (string.IsNullOrEmpty(Name))
            {
                ResultMessage = "姓名不能为空";
                return Page();
            }

            ResultMessage = $"欢迎你，{Name}！";
            // 复用原业务逻辑：数据库操作等
            return Page();
        }
    }
}

三、关键转换细节说明 #

• 服务器控件替换：asp:Label→原生<label>，asp:TextBox→<input>配合asp-for标签助手实现模型绑定，asp:Button→<button>通过asp-page-handler指定POST处理方法
• PostBack替代：WebForms的OnClick事件逻辑迁移到Razor Pages的OnPostXXX命名规范方法，通过表单post请求触发
• ViewState移除：用[BindProperty]标记模型属性，实现前端到后端的数据传递，不再依赖WebForms的ViewState机制
• 页面初始化：WebForms的Page_Load中!IsPostBack逻辑对应Razor Pages的OnGet方法，仅在页面首次加载时执行

四、批量转换替代方案 #

如果有大量页面需转换，可参考以下方式：

• 工具辅助：使用微软WebForms迁移助手批量生成Razor Pages基础代码，再手动调整控件绑定与业务逻辑细节
• 渐进式迁移：保留现有WebForms页面，通过反向代理实现与Razor Pages共存，逐步替换核心页面
• 逻辑复用：将WebForms中通用业务逻辑抽离为类库，在Razor Pages中直接引用，减少重复开发

内容的提问来源于stack exchange，提问作者J. Rent