本教程详细介绍了如何在 asp.net core mvc 应用中，通过表单提交将文本输入框的内容传递到控制器。文章从基本的 `name` 属性绑定讲起，逐步深入到使用 viewmodel 和 `asp-for` 标签助手进行更健壮的模型绑定，确保用户输入能够被后端正确接收和处理。
在构建交互式 Web 应用程序时，用户输入是不可或缺的一部分。尤其是在 ASP.NET Core MVC 应用中，如何有效地将 HTML 表单中的文本输入框内容安全、准确地传递到后端控制器进行处理，是开发者需要掌握的核心技能。本文将详细介绍两种主要方法：通过 name 属性进行基础绑定，以及通过 ViewModel 和标签助手进行更高级的模型绑定。
基础方法：使用 name 属性绑定
最直接的方法是为 HTML <input> 元素添加 name 属性，并确保控制器动作方法的参数名称与该 name 属性值匹配。当表单以 POST 方法提交时，浏览器会将所有具有 name 属性的输入字段及其值作为请求体的一部分发送到服务器。
HTML 表单结构：
在 Razor 视图中，我们需要修改 <input> 标签，为其添加一个 name 属性。这个 name 属性的值将用于在控制器中识别对应的输入数据。
<form method="post" action="@Url.Action("Index", "Home")">
<button class="btn btn-secondary my-2 my-sm-0" type="submit">Search</button>
<input class="form-control me-sm-2" type="text" name="search" placeholder="Enter Name">
</form>请注意，在 Url.Action 中，我们不再需要为 searchString 这样的参数占位符，因为 POST 请求的数据将通过请求体传递，而不是 URL 查询字符串。
控制器动作方法：
在后端控制器中，我们定义一个与 input 元素的 name 属性值（这里是 search）同名的参数。ASP.NET Core 的模型绑定系统会自动将表单提交的数据绑定到这个参数上。
public class HomeController : Controller
{
public IActionResult Index(string? search = null)
{
// 在这里可以使用 search 变量来处理用户输入的搜索字符串
ViewBag.SearchTerm = search;
// ... 其他逻辑，例如根据 search 过滤数据
return View();
}
}通过这种方式，当用户在文本框中输入内容并点击提交按钮时，search 变量将在 Index 动作方法中接收到用户输入的值。
进阶实践：利用 ViewModel 进行模型绑定
对于更复杂或包含多个输入字段的表单，使用 ViewModel 是一种更健壮、更易于维护的实践。ViewModel 是一个普通的 C# 类，用于封装特定视图所需的数据和用户输入。它有助于将视图逻辑与业务逻辑分离，并提供更好的数据验证支持。
定义 ViewModel：
首先，创建一个 ViewModel 类来表示表单的数据结构。例如，一个搜索功能可能只需要一个搜索字符串，但如果表单扩展，ViewModel 的优势将更加明显。
namespace YourAppName.Models
{
public class SearchViewModel
{
public string Search { get; set; }
// 如果有其他输入字段，可以继续添加属性
// public string OtherThing { get; set; }
}
}Razor 视图中使用 ViewModel 和标签助手：
在 Razor 视图中，我们首先通过 @model 指令声明当前视图将使用的 ViewModel 类型。然后，使用 ASP.NET Core 提供的 asp-for 标签助手来绑定输入字段。asp-for 标签助手会根据 ViewModel 的属性自动生成 name 属性、id 属性以及其他相关的 HTML 属性，简化开发并减少错误。
@model YourAppName.Models.SearchViewModel
<form method="post" action="@Url.Action("Index", "Home")">
<button class="btn btn-secondary my-2 my-sm-0" type="submit">Search</button>
<input class="form-control me-sm-2" type="text" asp-for="Search" placeholder="Enter Name">
@* 如果 ViewModel 有其他属性，可以这样绑定 *@
@* <input type="text" asp-for="OtherThing" /> *@
</form>控制器动作方法接收 ViewModel：
在控制器中，动作方法直接接收 ViewModel 实例作为参数。ASP.NET Core 的模型绑定器会尝试将请求体中的数据映射到 ViewModel 的对应属性上。
using YourAppName.Models; // 引入 ViewModel 的命名空间
public class HomeController : Controller
{
public IActionResult Index(SearchViewModel viewModel)
{
// 在这里可以通过 viewModel.Search 访问用户输入的搜索字符串
ViewBag.SearchTerm = viewModel.Search;
// ... 其他逻辑，例如根据 viewModel.Search 过滤数据
return View(viewModel); // 通常会将 ViewModel 传回视图以保持状态或显示错误
}
}这种方法不仅使代码更清晰，而且为后续的数据验证（通过数据注解）和复杂表单处理奠定了良好的基础。
注意事项与总结
- name 属性的重要性：无论是基础绑定还是模型绑定，HTML input 元素的 name 属性（或 asp-for 标签助手生成的 name 属性）是实现数据绑定的关键。它告诉服务器哪个数据对应哪个字段。
- POST 与 GET 的区别：本文主要讨论 POST 请求的数据提交。对于 GET 请求，数据通常通过 URL 查询字符串（例如 ?search=value）传递，此时控制器参数会从 URL 中获取值。
- 模型绑定的优势：使用 ViewModel 进行模型绑定是 ASP.NET Core MVC 中的推荐实践。它提供了类型安全、更好的代码组织、简化的数据验证以及对复杂数据结构（如嵌套对象、列表）的良好支持。
- Url.Action 的使用：在 POST 表单提交中，action 属性通常只需要指定目标控制器和动作方法即可，无需在 Url.Action 中包含表单输入字段的参数，因为这些数据将通过请求体发送。
通过掌握上述方法，开发者可以有效地在 ASP.NET Core MVC 应用程序中处理用户通过表单提交的文本输入框数据，从而构建功能强大且用户友好的 Web 应用。
