.NET 4.8升级至.NET 8后System.Web.UI报错，求解决方案及替代方案

核心原因 #

.NET 8 属于 .NET Core 生态系统，已彻底移除传统 ASP.NET Web Forms 相关的 System.Web.UI 命名空间、服务器控件及页面生命周期模型，这是升级后报错的根本原因。

解决方案与替代方案 #

根据项目依赖程度，可选择以下两种迁移路径：

1. 渐进式迁移（适用于大型Web Forms项目）

如果项目依赖大量 System.Web.UI 控件及逻辑，直接全量迁移成本过高：

• 保留原有 .NET 4.8 Web Forms 模块，将其封装为独立的 API 服务或微服务
• .NET 8 项目通过 HTTP 调用、gRPC 等方式对接旧模块功能，逐步替换核心业务逻辑
• 优先迁移无UI依赖的业务层代码，再逐步替换页面渲染部分

2. 全量迁移至 .NET 8 生态（适用于中小型项目）

直接替换 System.Web.UI 相关功能，采用 ASP.NET Core 原生方案：

页面渲染与服务器控件替代

状态管理替代

• ViewState：移除该依赖，改用 Session（需手动配置）、TempData 或客户端存储（localStorage/sessionStorage）
  配置 Session 示例（Program.cs）：

  var builder = WebApplication.CreateBuilder(args);
  // 添加Session服务
  builder.Services.AddSession(options =>
  {
      options.IdleTimeout = TimeSpan.FromMinutes(30);
      options.Cookie.HttpOnly = true;
  });
  builder.Services.AddControllersWithViews();
  
  var app = builder.Build();
  // 启用Session中间件（需在UseRouting之后、UseEndpoints之前）
  app.UseSession();
  app.UseRouting();
  app.UseAuthorization();
  app.MapControllerRoute(
      name: "default",
      pattern: "{controller=Home}/{action=Index}/{id?}");
  app.Run();
  

• Session：在 Razor Pages/MVC 中通过 HttpContext.Session 访问，需注意数据序列化（支持字符串、整数，复杂对象需手动序列化）

页面生命周期替代

Web Forms 的页面生命周期（Page_Load/Page_Init 等）替换为 ASP.NET Core 的请求管道：

• 用中间件处理全局请求逻辑
• 用 Action Filter 处理控制器/页面级别的请求前后逻辑
• 用 Razor Pages 的生命周期方法（OnGet/OnPost）替代 Page_Load

示例：Razor Pages 替代 Web Forms 数据展示 #

原 Web Forms 逻辑（简化）：

protected void Page_Load(object sender, EventArgs e)
{
    var items = GetItems();
    GridView1.DataSource = items;
    GridView1.DataBind();
}

.NET 8 Razor Pages 实现：

1. 后台代码（Index.cshtml.cs）：

public class IndexModel : PageModel
{
    public List<Item> Items { get; set; }

    public void OnGet()
    {
        // 替代Page_Load逻辑
        Items = GetItems();
    }

    private List<Item> GetItems()
    {
        return new List<Item>
        {
            new Item { Id = 1, Name = "Sample Item 1" },
            new Item { Id = 2, Name = "Sample Item 2" }
        };
    }
}

public class Item
{
    public int Id { get; set; }
    public string Name { get; set; }
}

2. 视图（Index.cshtml）：

@page
@model IndexModel

<table class="table table-striped">
    <thead>
        <tr>
            <th>ID</th>
            <th>Name</th>
        </tr>
    </thead>
    <tbody>
        @foreach (var item in Model.Items)
        {
            <tr>
                <td>@item.Id</td>
                <td>@item.Name</td>
            </tr>
        }
    </tbody>
</table>

内容的提问来源于stack exchange，提问作者Gaurav Jain