在.NET Core 7 Razor Pages中点击链接时设置Cookie的最优方案

核心思路 #

通过后端页面处理文化切换请求，在服务端设置Culture Cookie后跳转回原页面——这种方式比前端JS操作Cookie更安全，且能完美适配.NET本地化体系。

具体实现步骤 #

1. 创建文化切换处理页面
   在项目中添加CultureSwitch.cshtml页面及对应的PageModel，专门处理文化切换的Cookie设置和跳转逻辑：

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

namespace YourProjectNamespace.Pages;

public class CultureSwitchModel : PageModel
{
    public IActionResult OnGet(string culture, string returnUrl)
    {
        // 设置Culture Cookie，有效期设为30天，确保全站生效
        Response.Cookies.Append(
            CookieRequestCultureProvider.DefaultCookieName,
            CookieRequestCultureProvider.MakeCookieValue(new RequestCulture(culture)),
            new CookieOptions { Expires = DateTimeOffset.UtcNow.AddDays(30), Path = "/" }
        );

        // 跳转回原页面，若returnUrl无效则默认跳转到首页
        return LocalRedirect(returnUrl ?? "/");
    }
}

对应的CultureSwitch.cshtml可以是空白页面，因为仅需处理请求无需展示内容。

2. 修改HeaderViewComponent的视图链接
   在Components/Header/Default.cshtml中，将原跳转链接替换为指向CultureSwitch页面的链接，传递目标文化和当前页面URL参数：

@{
    var currentUrl = Context.Request.Path + Context.Request.QueryString;
}

<a asp-page="/CultureSwitch" asp-route-culture="zh-CN" asp-route-returnUrl="@currentUrl">中文</a>
<a asp-page="/CultureSwitch" asp-route-culture="en-US" asp-route-returnUrl="@currentUrl">English</a>

使用Razor标签助手生成正确URL，currentUrl确保用户切换文化后回到当前操作页面。

3. 确认本地化中间件配置
   在Program.cs中确保已启用本地化中间件，并配置好支持的文化（若未配置需补充）：

var builder = WebApplication.CreateBuilder(args);

// 添加本地化服务，指定资源文件路径
builder.Services.AddLocalization(options => options.ResourcesPath = "Resources");

builder.Services.AddRazorPages()
    .AddViewLocalization()
    .AddDataAnnotationsLocalization();

var app = builder.Build();

// 配置支持的文化列表
var supportedCultures = new[] { "zh-CN", "en-US" };
var localizationOptions = new RequestLocalizationOptions()
    .SetDefaultCulture(supportedCultures[0])
    .AddSupportedCultures(supportedCultures)
    .AddSupportedUICultures(supportedCultures);

// 启用本地化中间件
app.UseRequestLocalization(localizationOptions);

// 其他中间件配置
app.MapRazorPages();
app.Run();

方案优势 #

• 安全性高：服务端设置Cookie可避免前端JS操作带来的XSS风险，还能精准控制Cookie的有效期、作用路径等属性。
• 框架兼容性强：直接使用CookieRequestCultureProvider提供的方法生成Cookie值，与.NET本地化逻辑完全对齐。
• 用户体验流畅：切换文化后自动返回原页面，无需用户手动跳转。

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