AJAX请求Razor处理程序时如何让模型绑定识别JsonProperty属性名

问题根因 #

ASP.NET Core 3.0及以上版本默认使用System.Text.Json作为内置JSON序列化组件，你代码中使用的[JsonProperty]是Newtonsoft.Json（Json.NET）专属特性，默认模型绑定器不会识别该特性的配置，因此会出现提交的字段无法匹配、模型属性全部为null的问题。

方案1：继续使用Newtonsoft.Json（兼容现有[JsonProperty]特性） #

• 第一步：安装NuGet包 Microsoft.AspNetCore.Mvc.NewtonsoftJson
• 第二步：在服务注册逻辑中启用Newtonsoft.Json作为序列化器：
  若为.NET 6+ 顶级语句写法：

  var builder = WebApplication.CreateBuilder(args);
  // 在原有Razor Pages注册代码后追加配置
  builder.Services.AddRazorPages()
      .AddNewtonsoftJson();
  

  若为.NET 5及更早版本Startup.cs写法：

  public void ConfigureServices(IServiceCollection services)
  {
      services.AddRazorPages()
          .AddNewtonsoftJson();
  }
  

配置完成后现有[JsonProperty]标注即可被正常识别，AJAX提交的@first-name等字段会自动绑定到对应模型属性。

方案2：使用原生System.Text.Json特性（无需额外依赖） #

如果不想引入Newtonsoft.Json依赖，可以将模型类的特性替换为System.Text.Json专属的[JsonPropertyName]即可：

using System.Text.Json.Serialization;

public class ExampleClass 
{
    [JsonPropertyName("@first-name")]
    public string FirstName { get; set; }

    [JsonPropertyName("@last-name")]
    public string LastName { get; set; }
}

修改后无需额外配置，原生模型绑定器即可自动识别特性指定的JSON字段名完成绑定。

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