ASP.NET Core 中优雅处理可选 HTML 表单输入与默认值

在使用 ASP.NET Core 开发 web 应用时，我们经常会遇到需要处理 HTML 表单的场景，其中部分输入字段是可选的，或者需要设置合理的默认值。如果处理不当，很容易出现验证错误、数据异常或者用户体验不佳的问题。本文将介绍几种在 ASP.NET Core 中优雅处理可选表单输入与默认值的方式。

可选输入的基础处理方式

首先我们需要明确，HTML 表单中的可选输入指的是用户可以不填写该字段，提交表单时该字段值为空。在 ASP.NET Core 的模型绑定中，处理可选输入的核心是使用可空类型或者引用类型，配合合适的验证规则。

比如我们有一个用户注册的场景，其中用户的手机号是可选输入的，生日也是可选的，我们可以定义如下的视图模型：

// 用户注册视图模型
public class UserRegisterViewModel
{
    // 必填字段，用户名
    [Required(ErrorMessage = "用户名不能为空")]
    public string UserName { get; set; }

    // 必填字段，密码
    [Required(ErrorMessage = "密码不能为空")]
    [DataType(DataType.Password)]
    public string Password { get; set; }

    // 可选字段，手机号，使用可空类型
    [Phone(ErrorMessage = "手机号格式不正确")]
    public string? PhoneNumber { get; set; }

    // 可选字段，生日，使用可空 DateTime 类型
    public DateTime? Birthday { get; set; }

    // 可选字段，个人简介，引用类型默认可以为空
    public string? Introduction { get; set; }
}

上面的代码中，我们使用了可空引用类型（需要在项目文件中开启 <Nullable>enable</Nullable>）和可空值类型，这样即使表单中没有提交这些字段的值，模型绑定也不会报错，对应的属性会被赋值为 null。

为可选输入设置合适的默认值

很多时候，可选输入虽然允许为空，但在后续的业务处理中，我们可能希望给它一个默认的初始值，避免空值带来的判断麻烦。可以在视图模型初始化的时候设置默认值，或者在模型绑定完成后统一处理。

比如我们希望用户注册时，如果没有填写个人简介，默认设置为“该用户暂未填写个人简介”，可以在视图模型的构造函数中设置：

public class UserRegisterViewModel
{
    [Required(ErrorMessage = "用户名不能为空")]
    public string UserName { get; set; }

    [Required(ErrorMessage = "密码不能为空")]
    [DataType(DataType.Password)]
    public string Password { get; set; }

    [Phone(ErrorMessage = "手机号格式不正确")]
    public string? PhoneNumber { get; set; }

    public DateTime? Birthday { get; set; }

    public string? Introduction { get; set; }

    // 构造函数设置默认值
    public UserRegisterViewModel()
    {
        // 默认个人简介
        Introduction = "该用户暂未填写个人简介";
    }
}

如果是值的类型的可选字段，比如生日的默认值希望设置为当前日期，也可以类似处理：

public class UserRegisterViewModel
{
    // 其他属性省略...

    public DateTime? Birthday { get; set; }

    public UserRegisterViewModel()
    {
        // 默认生日为当前日期
        Birthday = DateTime.Now;
    }
}

需要注意的是，如果用户在表单中填写了对应的值，模型绑定会覆盖掉构造函数中设置的默认值，这样既保证了有默认值，又不影响用户的正常输入。

在 Razor 视图中渲染可选输入

在前端的 Razor 视图中，渲染可选输入时，我们不需要做额外的特殊处理，ASP.NET Core 的标签助手会自动处理可空类型的绑定。比如渲染手机号和个人简介的输入框：

<!-- 手机号输入框，可选 -->
<div class="form-group">
    <label asp-for="PhoneNumber" class="control-label"></label>
    <input asp-for="PhoneNumber" class="form-control" />
    <span asp-validation-for="PhoneNumber" class="text-danger"></span>
</div>

<!-- 个人简介输入框，可选 -->
<div class="form-group">
    <label asp-for="Introduction" class="control-label"></label>
    <textarea asp-for="Introduction" class="form-control"></textarea>
    <span asp-validation-for="Introduction" class="text-danger"></span>
</div>

<!-- 生日输入框，可选 -->
<div class="form-group">
    <label asp-for="Birthday" class="control-label"></label>
    <input asp-for="Birthday" type="date" class="form-control" />
    <span asp-validation-for="Birthday" class="text-danger"></span>
</div>

上面的代码中，即使 Birthday 是可空的 DateTime 类型，<input> 标签助手也会正确渲染，当用户没有选择日期时，提交表单该字段会为空，对应模型的 Birthday 属性为 null。

在控制器中处理可选输入与默认值

在控制器的 action 方法中，我们可以根据可选字段是否为空来决定后续的业务逻辑，也可以再次确认默认值是否符合要求。

public class AccountController : Controller
{
    [HttpPost]
    public IActionResult Register(UserRegisterViewModel model)
    {
        if (ModelState.IsValid)
        {
            // 处理手机号，如果为空则设置为默认值（比如空字符串，避免数据库存 null）
            if (string.IsNullOrEmpty(model.PhoneNumber))
            {
                model.PhoneNumber = "";
            }

            // 处理生日，如果为空则设置为默认日期，比如 1900-01-01
            if (!model.Birthday.HasValue)
            {
                model.Birthday = new DateTime(1900, 1, 1);
            }

            // 这里可以添加保存用户数据的逻辑
            // UserService.CreateUser(model);

            return RedirectToAction("RegisterSuccess");
        }

        // 验证失败，返回视图并保留用户输入
        return View(model);
    }
}

上面的代码中，我们在控制器中再次处理了可选字段的默认值，这是因为有时候构造函数中的默认值可能在模型绑定过程中被覆盖为 null（比如用户主动清空了输入框），所以在业务逻辑处理前统一兜底设置默认值会更稳妥。

使用自定义模型绑定器处理特殊场景

如果遇到更复杂的可选输入处理场景，比如表单中提交的字符串 "null" 或者 "undefined" 需要转换成 null，或者需要将空字符串自动转换成 null，我们可以自定义模型绑定器来实现。

下面是一个简单的自定义模型绑定器，用于将空字符串或者特定字符串转换成 null：

public class OptionalStringModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        if (bindingContext == null)
        {
            throw new ArgumentNullException(nameof(bindingContext));
        }

        // 获取绑定的值
        var valueProviderResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (valueProviderResult == ValueProviderResult.None)
        {
            // 没有值，设置为 null
            bindingContext.Result = ModelBindingResult.Success(null);
            return Task.CompletedTask;
        }

        var value = valueProviderResult.FirstValue;
        // 如果值是空字符串，或者等于 "null"、"undefined"，都设置为 null
        if (string.IsNullOrEmpty(value) || value == "null" || value == "undefined")
        {
            bindingContext.Result = ModelBindingResult.Success(null);
        }
        else
        {
            bindingContext.Result = ModelBindingResult.Success(value);
        }

        return Task.CompletedTask;
    }
}

然后在视图模型的属性上应用这个模型绑定器：

public class UserRegisterViewModel
{
    // 其他属性省略...

    [ModelBinder(BinderType = typeof(OptionalStringModelBinder))]
    public string? Introduction { get; set; }
}

这样即使前端提交了空字符串或者 "null" 这样的特殊值，模型绑定后 Introduction 属性都会是 null，方便后续统一处理。

总结

处理 ASP.NET Core 中的可选 HTML 表单输入与默认值，核心思路是：使用可空类型定义可选字段，在视图模型初始化或者控制器中设置合理的默认值，配合 Razor 标签助手正确渲染输入控件，遇到复杂场景可以自定义模型绑定器。这样的处理方式既符合用户的输入习惯，也能避免空值带来的业务异常，让代码更健壮、更易维护。

ASP.NET_Core表单处理可选输入默认值模型绑定