ASP.NET Core Razor Pages如何移除POST后URL的handler参数

要移除URL中?handler=Save这类后缀，核心是避免直接在POST请求响应中返回页面，而是通过重定向让浏览器发起新的GET请求到干净的页面地址——这也符合Web开发中Post/Redirect/Get（PRG）的最佳实践，还能防止用户刷新页面重复提交表单。

具体修改方法 #

只需要把后台处理方法里的return Page();替换为return RedirectToPage();即可：

[BindProperty]
public string UserName { get; set; } = "";

public IActionResult OnPostSave(string userType)
{
    SaveUserNameToService(UserName);
    // 重定向到当前页面，地址栏会自动清除handler参数
    return RedirectToPage();
}

如果需要传递保存成功的提示信息 #

如果想给用户显示保存成功的反馈，可以用TempData临时存储消息，重定向后TempData的数据会保留到下一次请求：

[BindProperty]
public string UserName { get; set; } = "";
// 定义TempData用于传递提示信息
[TempData]
public string SuccessMessage { get; set; }

public IActionResult OnPostSave(string userType)
{
    SaveUserNameToService(UserName);
    SuccessMessage = "用户名已成功保存！";
    return RedirectToPage();
}

然后在Razor页面中添加显示提示的代码：

@if (!string.IsNullOrEmpty(SuccessMessage))
{
    <div class="alert alert-success">@SuccessMessage</div>
}

<form method="post">
  <input asp-for="UserName" type="text" placeholder="* Your UserName" class="form-control input-lg">
  <button class="btn btn-sm btn-primary" type="submit" asp-page-handler="Save">
    Save
  </button>
</form>

原理说明 #

• 原来的return Page()是直接在POST请求的响应中渲染页面，浏览器地址栏会保留POST请求的完整URL（包含?handler=Save）。
• RedirectToPage()会返回一个302重定向响应，浏览器收到后会发起一个新的GET请求到当前页面的基础URL（也就是/UserNameSettings），地址栏就会显示干净的路径。

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