ASP.NET Core MVC视图中NumberFormat.NumberGroupSeparator不生效问题

问题场景 #

在ASP.NET Core MVC项目的Startup.cs中配置了RequestLocalizationOptions，自定义en-GB区域文化的NumberDecimalSeparator为.、NumberGroupSeparator为,,并设为默认请求文化。但视图中直接渲染decimal类型模型（如123456789.012）时，仅小数点分隔符生效，千位分隔符未生效，显示为123456789.012而非预期的123,456,789.012。手动在视图中转换为指定格式字符串可实现正确显示，但需要自动格式化的解决方案，同时疑惑为何仅NumberDecimalSeparator生效，NumberGroupSeparator及其他NumberFormat属性（如NumberDecimalDigits、NumberGroupSizes）存在类似问题。

配置代码（Startup.cs） #

public void ConfigureServices(IServiceCollection services)
{
    ...

    services.Configure<RequestLocalizationOptions>(options =>
    {
         CultureInfo en_GB = new CultureInfo("en-GB");
         en_GB.NumberFormat.NumberDecimalSeparator = ".";
         en_GB.NumberFormat.NumberGroupSeparator = ",";

         CultureInfo[] supportedCultures = new[]
         {
             en_GB
         };

         options.DefaultRequestCulture = new RequestCulture(en_GB, en_GB);

         options.SupportedCultures = supportedCultures;
         options.SupportedUICultures = supportedCultures;
    });

    ...
}

视图代码 #

@model decimal

<span>@Model</span>

手动转换可行示例 #

@model decimal

@{
    var numberFormatter = new CultureInfo("en-GB").NumberFormat;
    numberFormatter.NumberDecimalSeparator = ".";
    numberFormatter.NumberGroupSeparator = ",";
    var myFormattedNumber = Model.ToString("#,###.###", numberFormatter);
}

<span>@myFormattedNumber</span>

原因分析 #

1. 默认格式字符串限制：视图中直接渲染decimal时，默认使用G（常规）格式字符串，该格式默认不会应用千位分隔符，即使配置了NumberGroupSeparator。只有使用明确支持千位分隔的格式字符串（如N、#,###.###等）时，才会触发千位分隔符渲染。
2. RequestLocalization中间件未启用：如果Startup.cs的Configure方法中未调用app.UseRequestLocalization()，自定义文化不会被应用到请求上下文，可能导致部分格式设置不生效（小数点分隔符可能因系统默认或其他设置巧合生效）。
3. 文化配置未正确生效：若修改的CultureInfo实例未正确注册到请求上下文，视图渲染会使用系统默认文化设置，导致NumberGroupSeparator等配置不生效。

解决方案 #

方案1：启用RequestLocalization中间件 #

在Startup.cs的Configure方法中添加中间件启用代码，放在路由中间件之前：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    ...

    // 启用请求本地化
    app.UseRequestLocalization();

    app.UseRouting();
    ...
}

方案2：模型层添加DisplayFormat特性 #

在decimal类型的模型属性上添加[DisplayFormat]特性，指定格式字符串：

public class MyModel
{
    [DisplayFormat(DataFormatString = "{0:N3}", ApplyFormatInEditMode = true)]
    public decimal MyNumber { get; set; }
}

视图中直接渲染属性即可自动应用格式：

<span>@Model.MyNumber</span>

N3表示数值格式，保留3位小数并自动添加千位分隔符。

方案3：自定义全局HtmlHelper扩展 #

创建扩展方法自动处理decimal格式：

using Microsoft.AspNetCore.Mvc.Rendering;

public static class HtmlHelperExtensions
{
    public static IHtmlContent FormatDecimal(this IHtmlHelper htmlHelper, decimal value)
    {
        var culture = htmlHelper.ViewContext.HttpContext.RequestCulture.Culture;
        return htmlHelper.Raw(value.ToString("#,###.###", culture.NumberFormat));
    }
}

视图中使用扩展方法：

<span>@Html.FormatDecimal(Model)</span>

方案4：修改文化默认格式字符串 #

修改自定义CultureInfo的NumberFormat，让默认的G格式支持千位分隔：

services.Configure<RequestLocalizationOptions>(options =>
{
    CultureInfo en_GB = new CultureInfo("en-GB");
    en_GB.NumberFormat.NumberDecimalSeparator = ".";
    en_GB.NumberFormat.NumberGroupSeparator = ",";
    // 修改默认常规格式字符串，添加千位分隔
    en_GB.NumberFormat.GeneralFormat = "#,###.##########";

    CultureInfo[] supportedCultures = new[] { en_GB };

    options.DefaultRequestCulture = new RequestCulture(en_GB, en_GB);
    options.SupportedCultures = supportedCultures;
    options.SupportedUICultures = supportedCultures;
});

修改后视图直接渲染decimal时，会自动显示千位分隔符。

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