ASP.NET Core编辑状态下输入数字格式化失效问题排查

我当前使用如下代码构建表单输入：

<div class="form-group">
    @Html.TextBoxFor(m => m.TotalBudget, new { @class = "form-control"})
    @Html.ValidationMessageFor(m => m.TotalBudget, "", new { @class = "text-danger" })
</div>

该代码生成无格式化的数字类型输入框，我希望在编辑时将输入值格式化为$###,###,###.##格式（示例：$22,123.00、$3,000,000.12）。

我已尝试以下两种方式但均未生效：

1. 在TextBoxFor中添加@format参数：

<div class="form-group">
    @Html.TextBoxFor(m => m.TotalBudget, new { @class = "form-control", @format= "${###,###,###,###.##}" }) //@format= "{0:C2}"
    @Html.ValidationMessageFor(m => m.TotalBudget, "", new { @class = "text-danger" })
</div>

2. 在模型上添加DisplayFormat特性：

[DisplayFormat(DataFormatString = "{0:C2}", ApplyFormatInEditMode = true)]
[DisplayFormat(DataFormatString = "{$###,###,###,###.##}", ApplyFormatInEditMode = true)]

请问我哪里操作错误？

一、两种尝试的错误点 #

1. TextBoxFor的@format参数用法错误：
   TextBoxFor的格式参数是独立的第二个参数，而非HTML属性集合的成员。你把@format放到了HTML属性对象里，会被当成普通HTML属性渲染，根本起不到格式化数值的作用。

2. 模型DisplayFormat特性误用：

• 重复添加[DisplayFormat]特性只会生效最后一个，前面的会被直接覆盖；
• 自定义格式字符串写法错误，正确格式必须包含占位符{0}，你写的"{$###,###,###,###.##}"不符合.NET格式规则，正确写法应为"{0:$###,###,###.##}"。

二、正确实现方式 #

方式1：使用TextBoxFor的正确重载传入格式

直接把格式字符串作为第二个参数传入，第三个参数放HTML属性集合：

<div class="form-group">
    @Html.TextBoxFor(m => m.TotalBudget, "{0:$###,###,###.##}", new { @class = "form-control" })
    @Html.ValidationMessageFor(m => m.TotalBudget, "", new { @class = "text-danger" })
</div>

如果想用系统内置货币格式，也可以写成"{0:C2}"，注意需确保系统区域设置匹配美元符号显示。

方式2：模型标注DisplayFormat配合EditorFor

TextBoxFor默认不会读取模型的DisplayFormat配置，换成EditorFor即可自动应用格式：
首先修正模型特性：

[DisplayFormat(DataFormatString = "{0:$###,###,###.##}", ApplyFormatInEditMode = true)]
// 或者用系统货币格式：[DisplayFormat(DataFormatString = "{0:C2}", ApplyFormatInEditMode = true)]
public decimal TotalBudget { get; set; }

视图中替换为EditorFor：

<div class="form-group">
    @Html.EditorFor(m => m.TotalBudget, new { htmlAttributes = new { @class = "form-control" } })
    @Html.ValidationMessageFor(m => m.TotalBudget, "", new { @class = "text-danger" })
</div>

三、额外说明 #

上述后端格式化仅在页面首次加载时生效，如果需要用户输入过程中实时自动添加千分位、美元符号，还需要补充前端JavaScript逻辑实现动态格式化。

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