ASP.NET Core中处理可选HTML表单输入及设置默认值
在Web开发中，HTML表单是与用户交互的核心组件，我们经常会遇到需要处理可选输入项的需求，同时还要为未填写的可选项设置合理的默认值。本文将介绍在ASP.NET Core项目中，如何结合前端HTML表单和后端模型绑定，正确处理可选表单输入并设置默认值。
场景说明
假设我们需要开发一个用户信息收集页面，其中“用户昵称”和“个人简介”是必填项，“生日”和“所在城市”是可选填项。如果用户在可选填项中没有输入内容，后端需要自动为其设置默认值，比如生日默认设为“2000-01-01”，城市默认设为“未填写”。
后端模型定义
首先我们需要定义一个对应的模型类，用来接收表单提交的数据。对于可选输入项，我们可以使用可空类型，或者在属性中设置默认值，同时配合数据注解来标记必填项。
using System.ComponentModel.DataAnnotations;
namespace AspNetCoreFormDemo.Models
{
public class UserInfoViewModel
{
// 必填项，设置显示名称和必填校验
[Display(Name = "用户昵称")]
[Required(ErrorMessage = "用户昵称不能为空")]
public string NickName { get; set; }
[Display(Name = "个人简介")]
[Required(ErrorMessage = "个人简介不能为空")]
public string Introduction { get; set; }
// 可选项：生日，使用可空DateTime类型，允许为空
[Display(Name = "生日")]
public DateTime? Birthday { get; set; }
// 可选项：所在城市，字符串类型，允许为空
[Display(Name = "所在城市")]
public string City { get; set; }
}
}上面的模型中，Birthday使用DateTime?可空类型，表示用户可以不填写该字段；City为字符串类型，默认值为null，同样支持不填写。必填项通过Required特性标注，提交时会自动进行校验。
前端表单设计
接下来我们需要在Razor视图中编写HTML表单，可选输入项不设置required属性，让用户可以自由选择是否填写。注意这里提到的<input>、<textarea>等标签都需要正确编写，表单的提交地址指向后端的SubmitUserInfo方法。
<form asp-action="SubmitUserInfo" method="post">
<div class="form-group">
<label asp-for="NickName"></label>
<input asp-for="NickName" class="form-control" />
<span asp-validation-for="NickName" class="text-danger"></span>
</div>
<div class="form-group">
<label asp-for="Introduction"></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"></label>
<!-- 可选项不添加required属性 -->
<input asp-for="Birthday" type="date" class="form-control" />
</div>
<div class="form-group">
<label asp-for="City"></label>
<input asp-for="City" class="form-control" placeholder="可选填，默认值为未填写" />
</div>
<button type="submit" class="btn btn-primary">提交</button>
</form>表单中使用了ASP.NET Core的Tag Helper（如asp-for、asp-action），可以自动生成对应的name、id等属性，方便后端模型绑定。可选项没有添加required属性，用户可以不填写直接提交。
后端处理逻辑
当用户提交表单后，后端控制器方法接收模型数据，此时需要判断可选输入项是否为空，如果为空则设置默认值。我们可以在模型绑定完成后，手动处理默认值，也可以在模型属性中直接设置默认值。
第一种方式是在控制器方法中处理：
using AspNetCoreFormDemo.Models;
using Microsoft.AspNetCore.Mvc;
namespace AspNetCoreFormDemo.Controllers
{
public class UserController : Controller
{
[HttpGet]
public IActionResult UserInfo()
{
return View();
}
[HttpPost]
public IActionResult SubmitUserInfo(UserInfoViewModel model)
{
if (ModelState.IsValid)
{
// 处理可选输入项的默认值
if (!model.Birthday.HasValue)
{
// 如果用户未填写生日，设置默认值为2000-01-01
model.Birthday = new DateTime(2000, 1, 1);
}
if (string.IsNullOrEmpty(model.City))
{
// 如果用户未填写城市，设置默认值为未填写
model.City = "未填写";
}
// 这里可以执行业务逻辑，比如将数据存入数据库
// 示例中仅返回提交成功页面，展示处理后的数据
return View("SubmitSuccess", model);
}
// 校验不通过，返回表单页面并保留用户输入
return View("UserInfo", model);
}
}
}第二种方式是直接在模型属性中设置默认值，这样不需要在控制器中重复处理：
using System.ComponentModel.DataAnnotations;
namespace AspNetCoreFormDemo.Models
{
public class UserInfoViewModel
{
[Display(Name = "用户昵称")]
[Required(ErrorMessage = "用户昵称不能为空")]
public string NickName { get; set; }
[Display(Name = "个人简介")]
[Required(ErrorMessage = "个人简介不能为空")]
public string Introduction { get; set; }
[Display(Name = "生日")]
public DateTime? Birthday { get; set; } = new DateTime(2000, 1, 1); // 直接设置默认值
[Display(Name = "所在城市")]
public string City { get; set; } = "未填写"; // 直接设置默认值
}
}第二种方式更简洁，模型初始化时就会赋予默认值，即使表单没有提交对应字段，属性也会保留默认值。不过需要注意，如果表单提交了空字符串给City字段，模型绑定后City会是空字符串而不是默认值，此时还是需要在控制器中做额外的空判断。
提交成功页展示
提交成功后，我们可以创建一个视图来展示用户提交的数据，包括处理后的默认值：
<h2>提交成功</h2>
<p>用户昵称：@Model.NickName</p>
<p>个人简介：@Model.Introduction</p>
<p>生日：@Model.Birthday.Value.ToString("yyyy-MM-dd")</p>
<p>所在城市：@Model.City</p>
<p><a href="/User/UserInfo">返回表单页</a></p>注意事项
- 如果需要区分用户是“未填写”还是“主动提交了空值”，可以使用可空类型结合额外的标识字段，或者在提交时做更细致的判断。
- 前端的<input>标签如果设置了
type="date"，用户不填写时提交的是空字符串，后端模型绑定可空DateTime类型时会转为null，此时处理默认值即可。 - 数据校验时，可选输入项不要添加
Required特性，避免用户不填写时被判定为校验失败。