ASP.NET Core MVC 从入门到精通之Html辅助标签补充及模型校验基础

news2024/11/27 1:41:18

随着技术的发展，ASP.NET Core MVC也推出了好长时间，经过不断的版本更新迭代，已经越来越完善，本系列文章主要讲解ASP.NET Core MVC开发B/S系统过程中所涉及到的相关内容，适用于初学者，在校毕业生，或其他想从事ASP.NET Core MVC 系统开发的人员。

经过前几篇文章的讲解，初步了解ASP.NET Core MVC项目创建，启动运行，以及命名约定，创建控制器，视图，模型，接收参数，传递数据ViewData，ViewBag，路由，页面布局，wwwroot和客户端库，Razor语法，EnityFrameworkCore与数据库，HttpContext，Request，Response，Session，序列化，文件上传，自动映射，Html辅助标签等内容，今天继续讲解ASP.NET Core MVC 中Html辅助标签第二部分及模型校验基础等相关内容，仅供学习分享使用。

在上一篇文章中，讲解了辅助标签的ActionLink，Label，Text，RadioButton，CheckBox，TextArea，Password，Form等标签，今天继续在前一篇的基础上，讲解第二部分内容。

下拉框DropDownList和多选列表框ListBox

1. 下拉框

下拉框主要用于显示多个信息，供用户选择，主要用于单选，主要用@Html.DropDownList表示，共有6个重载，各个参数如下所示：

expression：表达式名称，一般用于表示文本框的name。
selectList：下拉列表的数据源，IEnumerable<SelectListItem>类型，一般用SelectList实现。
optionLabel：默认显示的文本
htmlAttributes：超链接Html属性，如：style，class，width，height等，可以接收匿名对象。

下拉框示例

首先准备数据源，一般是从数据库中获取，如下所示：

List<City> cityList = new List<City>
{
    new City() { Id = 1, Name = "北京" },
    new City() { Id = 2, Name = "上海" },
    new City() { Id = 3, Name = "广州" },
    new City() { Id = 4, Name = "深圳" }
};
var citys = new SelectList(cityList, "Id", "Name");
ViewBag.Citys = citys;

其中SelectList是IEnumerable<SelectListItem>的实现类，传入list，并制定value和text即可。

@Html.Label("City","城市",new { style="width:90px;"})
@Html.DropDownList("City", ViewBag.Citys,"请选择",new {style="width:120px;"})

2. 多选列表

多选列表框主要用于显示多个信息，供用户选择，一般用于多选，主要用@Html.ListBox表示，共有3个重载，各个参数如下所示：

expression：表达式名称，一般用于表示文本框的name。
selectList：下拉列表的数据源，IEnumerable<SelectListItem>类型，一般用SelectList实现。
htmlAttributes：超链接Html属性，如：style，class，width，height等，可以接收匿名对象。

多选列表框示例

@Html.Label("MultiCity","多选城市",new { style="width:90px;vertical-align:top;"})
@Html.ListBox("MultiCity", ViewBag.Citys,new {style="width:120px;"})

3. 下拉框和多选框Html原生代码

上述示例的下拉框和列表框，对应的原生Html代码，如下所示：

<label for="City" style="width:90px;">城市</label>
<select id="City" name="City" style="width:120px;">
    <option value="">请选择</option>
    <option value="1">北京</option>
    <option value="2">上海</option>
    <option value="3">广州</option>
    <option value="4">深圳</option>
</select>
<br>
<br>
<label for="MultiCity" style="width:90px;vertical-align:top;">多选城市</label>
<select id="MultiCity" multiple="multiple" name="MultiCity" style="width:120px;">
    <option value="1">北京</option>
    <option value="2">上海</option>
    <option value="3">广州</option>
    <option value="4">深圳</option>
</select>

Html转义

有些时候，会输出特定格式的内容，但是在C#输出时会进行转义，进而达不到想要的效果，这时需要用到@Html.Raw方法。共2个重载，主要参数，如下所示：

value：需要是输出的内容，有string和TModel两种类型。

@Html.Raw示例

@Html.Raw("<font color='red'>大家好，这是测试Raw输出</font>")

上述方法会输出原生Html<font color='red'>大家好，这是测试Raw输出</font>，在页面上显示红色的文本内容。而不是输出转义后的内容。

模型校验

在实际的应用开发中，我们总需要写很多的验证，这个是避免不了的，不写，安全上过不去，写了，又很繁琐。健壮的应用程序，不仅前端要写验证，后端也需要写验证，才能杜绝非法数据入侵。

实施验证的过程可能有些单调乏味，但却必不可少。在 MVC 中，验证发生在客户端和服务器上。幸运的是，.NET 已将验证抽象化为验证属性。这些属性包含验证代码，从而减少了所需编写的代码量。

通过读取整个模型即可显示有关此应用的数据的规则，从而使代码维护变得更轻松。下面是几个常用的内置验证属性：

[CreditCard]：验证属性是否具有信用卡格式。
[Compare]：验证某个模型中的两个属性是否匹配。
[EmailAddress]：验证属性是否具有电子邮件格式。
[Phone]：验证属性是否具有电话格式。
[Range]：验证属性值是否落在给定范围内。
[RegularExpression]：验证数据是否与指定的正则表达式匹配。
[Required]：将属性设置为必需属性。
[StringLength]：验证字符串属性是否最多具有给定的最大长度。
[Url]：验证属性是否具有 URL 格式。

模型校验步骤

1. 模型中增加校验特性

在模型中增加校验特性，如下所示：

using System.ComponentModel.DataAnnotations;

namespace DemoCoreMVC.Models
{
    public class User
    {
        [Required(ErrorMessage ="Id不能为空")]
        [Range(0, 100,ErrorMessage ="Id必须的0到100之内")]
        public int Id { get; set; }

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

        [Required(ErrorMessage ="邮箱不可为空")]
        [EmailAddress(ErrorMessage ="邮件不符合格式")]
        public string Email { get; set; }
    }
}

2. 引入校验分部视图

在View视图中增加校验脚本引入，如下所示：

<!--Edit.cshtml文件的底部增加以下引入部分视图-->
@section Scripts{
    @(await Html.PartialAsync("_ValidationScriptsPartial"))
}

3. 增加校验信息标签

在Edit.cshtml需要显示校验信息的地方，增加@Html.ValidationMessageFor信息展示，如下所示：

@using (Html.BeginForm("Save","User",FormMethod.Post))
{
    @Html.Label("Id","User Id",new { style="width:90px;"});
    @Html.TextBox("Id",Model.Id)
    @Html.ValidationMessageFor(p=>p.Id)
    <br />
    <br />
    @Html.Label("Name","User Name",new { style="width:90px;"})
    @Html.TextBox("Name",Model.Name)
    @Html.ValidationMessageFor(p=>p.Name)
    <br />
    <br />
    @Html.Label("Email","E-Mail",new { style="width:90px;"})
    @Html.TextBox("Email",Model.Email)
    @Html.ValidationMessageFor(p=>p.Email)
    <br />
    <br />
    <input type="submit" value="保存" class="btn btn-primary" />
}