Razor Pages中@functions与PageModel的区别及成员声明疑问

一、成员声明的差异与影响 #

Razor Pages里的@functions块和PageModel是完全独立的两个类，核心差异和影响如下：

• 类继承与定位：PageModel是.cshtml.cs文件中的类，继承自PageModel基类，是页面的逻辑核心，负责处理HTTP请求（OnGet/OnPost等Action）、数据绑定、验证等后端逻辑；@functions块定义的是.cshtml页面自身生成的类的成员，该类继承自Page基类，仅用于辅助页面渲染，比如定义模板内用的格式化方法、局部状态等。
• 请求处理能力：只有PageModel中的OnGet/OnPost等方法会被ASP.NET Core框架自动识别为请求处理Action；@functions块里的同名方法不会被框架调用，仅能在页面模板中手动触发。
• 生命周期与作用域：PageModel的成员绑定HTTP请求生命周期，是请求级别的；@functions块的成员属于页面实例，仅在当前页面渲染过程中有效。
• 可维护性：官方建议将业务逻辑、请求处理代码放在PageModel中，实现关注点分离；@functions块仅适合存放简单的页面渲染辅助逻辑，避免让页面模板变得臃肿。

二、同名成员的优先级 #

由于@functions块和PageModel属于不同类，同名成员不会产生冲突，但在页面模板中有明确的访问优先级：

• 直接引用成员名称时，优先访问@functions块内的成员；
• 若要访问PageModel中的同名成员，必须通过Model.成员名的方式显式指定。

示例代码：

@page "/"
@model IndexModel

<!-- 输出@functions块的Title -->
<h1>@Title</h1>
<!-- 输出PageModel的Title -->
<h2>@Model.Title</h2>

@functions {
    public string Title = "页面级标题";
}

// IndexModel.cs
public class IndexModel : PageModel
{
    public string Title = "PageModel级标题";

    public void OnGet()
    {
    }
}

运行后，h1会显示“页面级标题”，h2显示“PageModel级标题”。

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