如何扩展Razor Pages？ASP.NET Core 2.2标准页面扩展方案问询

嘿，这个需求我之前也遇到过——要复用共享的Razor Pages同时又能在项目里自定义逻辑，还不能动原代码，你的思路完全走对了，而且这个方案是完全可行的！下面给你一步步拆解实现方法，还有几个替代方案供你参考：

核心实现思路：自定义PageModel + 指定返回Standard视图 #

你的想法是对的：在Custom目录下创建继承自Standard页面PageModel的类，重写或新增方法，然后让这个自定义PageModel返回Standard目录下的cshtml视图。具体步骤如下：

1. 改造Standard页面的PageModel（仅需一次，所有项目共享） #

首先要确保Standard页面的PageModel中，需要被重写的方法标记为virtual，这样子类才能扩展：

// Pages/Standard/Index.cshtml.cs
public class StandardIndexModel : PageModel
{
    // 标记为virtual允许子类重写
    public virtual IActionResult OnGet()
    {
        // 原始共享逻辑
        ViewData["Message"] = "来自Standard的默认消息";
        return Page();
    }
}

2. 在Custom目录下创建扩展的PageModel #

不需要创建对应的cshtml文件，只需要新建一个继承自Standard PageModel的类，重写或新增方法：

// Pages/Custom/Index.cs
public class CustomIndexModel : StandardIndexModel
{
    // 重写OnGet方法，替换或扩展逻辑
    public override IActionResult OnGet()
    {
        // 可以选择调用base.OnGet()复用原始逻辑，也可以完全重写
        base.OnGet();
        // 新增自定义逻辑
        ViewData["Message"] = "来自Custom的扩展消息";
        
        // 关键：返回Standard目录下的cshtml视图，传入当前Model
        return View("/Standard/Index.cshtml", this);
    }

    // 新增自定义端点方法
    public IActionResult OnGetMyCustomGet()
    {
        ViewData["CustomMessage"] = "这是自定义的Get方法返回内容";
        return View("/Standard/Index.cshtml", this);
    }
}

3. 配置路由让请求匹配到Custom的PageModel #

因为Custom目录下没有对应的cshtml文件，默认路由不会自动匹配到CustomIndexModel，这里有两种简单的配置方式：

方式A：创建空的Custom页面文件

在Pages/Custom/Index.cshtml中仅保留路由和Model指定，然后渲染Standard视图：

@page "/index" // 指定路由，比如让访问根路径/index时用这个逻辑
@model YourProjectNamespace.Pages.Custom.CustomIndexModel

@{
    // 直接渲染Standard的视图内容
    await Html.RenderPartialAsync("/Standard/Index.cshtml", Model);
}

方式B：使用PageRoute特性（ASP.NET Core 2.2+支持）

直接在CustomIndexModel上添加路由特性，无需创建cshtml文件：

[PageRoute("/index")]
public class CustomIndexModel : StandardIndexModel
{
    // ... 原有逻辑
}

替代方案：使用类库封装Standard页面 #

如果Standard页面需要在多个项目间完全共享，更优雅的方式是把Standard页面封装成Razor类库：

1. 创建一个Razor类库项目，将Standard页面放入其中，确保PageModel方法标记为virtual。
2. 在各个业务项目中引用这个类库。
3. 业务项目的Custom目录下创建继承自类库中Standard PageModel的类，按照上面的方法指定返回类库中的视图路径（类库中的视图路径通常以/Components/开头，需要调整对应路径）。

注意事项 #

• 确保Standard页面的cshtml中@model指定的是基类（比如StandardIndexModel），这样子类CustomIndexModel可以正确绑定视图。
• 如果需要复用Standard页面的布局，无需额外配置，视图会自动继承项目的布局设置。
• 测试时要验证：请求路由到Custom的PageModel时，执行的是自定义逻辑，而渲染的是Standard的视图内容。

内容的提问来源于stack exchange，提问作者Leonardo Lurci