• 博客园logo
  • 会员
  • 众包
  • 新闻
  • 博问
  • 闪存
  • 赞助商
  • HarmonyOS
  • Chat2DB
    • 搜索
      所有博客
    • 搜索
      当前博客
  • 写随笔 我的博客 短消息 简洁模式
    用户头像
    我的博客 我的园子 账号设置 会员中心 简洁模式 ... 退出登录
    注册 登录
成为自己最想成为的那种人
博客园    首页    新随笔    联系   管理    订阅  订阅
第一个 MVC 应用程序(下半部分)

  2.4 创建一个简单的数据录入应用程序

    本章的其余部分将通过一个简单的数据录入应用程序来考查 MVC 的更多基本特性。本小节打算分步进行,目的是演示 MVC 的运用。

B1、设计一个数据模型

    在 MVC 中,M 代表模型(Model),它是应用程序最重要的部分。

    模型是定义应用程序主题的现实对象、过程以及规则的表示,称为域。

    模型,通常称为域模型,包含应用程序域中要建立的 C#对象,称为域对象。这些域对象构成了应用程序的全部事物以及操纵这些
  对象的方法。

    视图和控制器以一致的方式将域暴露给客户端。

    一个设计良好的 MVC 应用程序,必须从设计良好的模型开始,它是随后添加控制器和视图的焦点。

    (对于 “晚会邀请”应用程序,不需要复杂的模型。因为这是一个简单的应用程序,只需要创建一个域类(可以称为 GuestResponse),由它负责存储、验证并确认“回复邀请”)

  添加模型类

    MVC 的约定是将建立模型的类放在 “Models”文件夹中,该文件夹是 Visual Studio 最初建立项目时创建的。

    1、右击 “Models”文件夹——“添加”——“类”

    2、将文件名设置为 “GuestResponse.cs”

    3、单击“添加”按钮。(创建完成后修改文件内容——为模型对象类添加属性)

    (可以通过问号“?” 将 “int”、“bool” 等类型的属性设置为可空的类型)

B2、★ 链接动作方法

    该应用程序的目标之一是要包括一个回复邀请的表单,因此需要在 Index.cshtml 视图中添加一个指向它(动作方法)的链接。

        ……
        @Html.ActionLink("现在回复", "RsvpForm")
        ……

    Html.ActionLink 是一个 HTML 的辅助器方法(Helper Method)

    MVC 框架附带了一组内置的辅助器方法,它们可以方便地用来渲染 HTML 的链接、文本输入框、复选框 以及其他种类的内容。

    这个 ActionLink 方法有两个参数:第一个是该链接的显示文本,第二个是用户单击该链接时将要执行的动作。

    (第21~23章将解释完整的 HTML 辅助器方法集合)

    Html.ActionLink 方法已经检测了应用程序的 URL 路由配置,并得出 /Home/RsvpForm 是一个指向 HomeController 控制器
  上 RsvpForm 动作的 URL。

    (与传统的 ASP.NET 应用程序不同,MVC 的 URL 并不对应物理文件。每个动作方法有它自己的 URL,而 MVC 使用 ASP.NET
  的路由系统将这些 URL 转换成动作)

  创建动作方法:

    此时,可以在 HomeController 类中添加一个名称为 “RsvpForm” 的方法来完成这一工作。

        public ViewResult RsvpForm()
        {
          return View();
        }

  添加强类型视图:

    这里打算为 RsvpForm 动作方法添加一个视图,但采取了稍有不同的方式——创建一个强类型视图。

    强类型视图意在渲染一个特定的域类型,而且,如果指定了想使用的类型(本例是 GuestResponse),MVC 将能够提供一些

  便于使用这个类型的便捷方法,从而可以在视图中方便地使用这个类型对象。

    (在做进一步工作之前,要确保已编译了 MVC 项目。如果已经创建了 GuestResponse 类,但未进行编译,MVC 将不能为这个

  类型创建强类型视图。 要编译应用程序,可以 “生成”——“生成解决方案”,或简单地按快捷键 F6)

    1、在代码编辑器中右击 ResvForm 方法,然后选择 “添加视图”

    2、确保将 “视图名”设置为 “ResvForm”,将“模板”设置为 “空模板”,并从“类模板”字段的下拉列表中
  选择“GuestResponse(PartyInvites.Models)”,让(视图)选项中的复选框处于未选状态。

    3、单击 “添加”按钮。(这是另一种结构的 HTML 文件,它包含了一个 @model 的 Razor 表达式。过一会儿就会明白,这是
  强类型视图,并是为视图提供便利的关键——@model PartyInvites.Models.GuestResponse)

    (在创建视图时,所选择和勾选的选项决定了视图文件的初始内容(跟别的文件没有关系),其他没什么作用。例如,
  你可以将常规视图修改成强类型视图,只需在代码编辑器中添加或去除 @model 指示符 即可)

B3、建立表单

    现在已经创建了强类型视图,可以扩建这个 RsvpForm.cshtml 的内容(在 RsvpForm.cshtml 文件中创建表单视图)

        @using (Html.BeginForm())
        {
          <p>姓名:@Html.TextBoxFor(x=>x.Name) </p>
          <p>邮箱:@Html.TextBoxFor(x=>x.Email) </p>
          <p>手机:@Html.TextBoxFor(x=>x.Phone) </p>
          <p>是否参加?@Html.DropDownListFor(x=>x.WillAttend, new[ ] {
              new SelectListItem() { Text="是,我参加", value=bool.TrueString },
              new SelectListItem() { Text="否,不参加", value=bool.FalseString }
            }, “请选择”)
           </p>
          <input type="submit" value="回复邀请" />
        }

    这里对 GuestResponse 模型类的每一个属性都使用了一个 HTML 辅助器方法,以便渲染一个适当的 HTML 的 input 控件。

    这些辅助器方法都能够用一个 lambda 表达式来选择与 input 元素有关的属性。(如:@Html.TextBoxFor(x=>x.Phone))

    这个 TextBoxFor 辅助器方法会生成一个 input 元素的 HTML,将该元素的 type 参数设置为“text”,id 和 name 标签属性设置
  为“Phone”,Phone 是所选域类的属性名。于是为模型属性 Phone 生成了一个文本输入框的 HTML 标记,如下所示:

        <input id="Phone" name="Phone" type="text" value="" />

    这种灵活的特性是能够起作用的,因为 RsvpForm 视图是强类型的,而且已经告诉 MVC,GuestResponse 是希望用该视图
  渲染的类型。——这为 HTML 辅助器方法提供了所需的信息,使其能够理解从 @mldel 表达式所读取的属性是哪一种数据类型。

    替代运用 lambda 表达式的另一种方法是将模型类型的属性名指定为一个字符串,如:@Html.TextBox("Email")

    另一个便利的辅助器方法是 Html.BeginForm,它生成一个回递给动作方法的 HTML 表单元素(<form>元素)
    这里未给辅助器方法传递任何参数,于是它假设要回递的目标是请求此 HTML 文档的同一个 URL。

    一个整洁的技巧是将它封装在一个 C# 的 using 语句中,如:@using (Html.BeginForm()) { }。

    正常情况下,像这样运用 using 语句,会在对象超出范围时确保收回对象所占用的资源。例如,它通常用于数据库连接。
    但这里并不是清理对象,而是 Html.BeginForm 辅助器在它超出范围时关闭 HTML 的 form 元素。——这意味着,
  Html.BeginForm 辅助器方法会创建 form 元素的两部分(<form>元素的开标签和闭标签),如下所示:

        <form action="/Home/RsvpForm" method="post">
          …这里是表单内容…
        </form>

    这里的关键是演示如何用 HTML 辅助器方法创建一个表单。

B4、处理表单

    这里尚未告诉 MVC,将表单递交给服务器时要做什么。(此时,单击“恢复邀请”按钮只会清除掉表单中已经输入的值。这是因为

  该表单会回递给 Home 控制器中的 RsvpForm 动作方法,这只是告诉 MVC 再次渲染该视图——视图被再次渲染时,输入的数据会消失)

    为了接收并处理表单所递交的数据,这里打算使用一个聪明的特性——添加第二个 RsvpForm 动作方法,以形成如下作用:

    一种方法用于响应 HTTP 的 GET 请求:GET 请求是某人单击一个链接时,浏览器正常发出的请求。当有人第一次访问/Home

  /RsvpForm 时,这个动作负责显示最初的空白表单。

    一种方法用于响应 HTTP 的 POST 请求:默认情况下,用 Html.BeginForm() 渲染的表单是由浏览器作为一个 POST 请求

  递交的。这个动作负责接收所递交的数据,并决定用它做什么。

    以独立的 C#方法分别处理 GET 和 POST 请求,有助于保持控制器代码整洁,因为这两种方法有不同的职责。

    这两种方法都由相同的 URL 进行调用,但 MVC 确保会根据所处理的是 GET 请求或 POST 请求,来调用合适的方法。

  在 HomeController.cs 文件中添加一个支持 POST 请求的动作方法:

        ……
        using PartyInvites.Models;
        ……

        [ HttpGet ]
        public ViewResult RsvpForm()  { return View(); }

        [ HttpPost ]
        public ViewResult RsvpForm(GuestResponse  gr)
        {
          return View("Thanks", gr);
        }

    这里在已有的 RsvpForm 动作方法上添加了 HttpGet 注解属性。这是告诉 MVC,该方法应该仅用于 GET 请求。

    然后添加了一个重载版的 RsvpForm 方法,它带有一个 GuestResponse 参数,并运用了 HttpPost 注解属性。(该注解属性告诉 MVC ,这个新方法将处理 POST 请求)

    这里已经引入了 PartyInvites.Models 命名空间,这样便可以直接使用 GuestResponse 模型类型,而不需要使用这个类的限定名。

    点击查看对该清单所做的添加是如何工作的

B5、添加验证

    验证是为了防止用户输入无意义的数据,甚至是递交空白的表单。

    在 MVC 应用程序中,验证典型地运用于域模型,而不是用户界面。这意味着可以在一个地方(模型类中)定义验证条件,而在运用模型类的任何地方生效。

    ASP.NET MVC 支持验证规则声明,这是以 System.ComponentModel.DataAnnotations 命名空间中的注解属性进行定义的 —— 意即,验证约束是使用标准的 C# 注解属性特性来表示的。

  如下演示如何将这些注解属性运用于 GuestResponse 模型类:

      using System.ComponentModel.DataAnnotation;

      [ Required( ErrorMessage = "Please enter your name" )]    // 意思是运用 Name 属性的地方不能为空,为空则显示对应的错误信息
      public string Name { get; set; }

      [ Required( ErrorMessage = "Please enter your email address" )]    //一个属性可以有多个注解属性
      [ RegularExpression( ".+\\@.+\\..+", ErrorMessage = "Please enter a valid email address" ) ]
      public string Email { get; set; }

    MVC 会自动地侦测这些验证注解属性,并在模型绑定过程中将它们用于验证数据。

    一个可空的 bool 型(bool?)有3个可能的值:true、false 和 null。 如果用户尚未选择,系统会默认用 null 来表示,这会让 Required 注解属性能够报告一个验证错误。这是 MVC 框架如何优雅地将 C# 特性与 HTML 和 HTTP 相融合的一个很好的示例。

    可以在控制器中使用 ModelState.IsValid 属性来检查是否有验证问题。(如下所示,在 HOME 控制器类的启用 POST 的 RsvpForm 动作方法中的实现)

        [ HttpPost ]
        public ViewResult RsvpForm( GuestResponse guestResponse)
        {
          if( ModelState.IsValid)
          {
            return View("Thanks", guestResponse) ;    // 第一个参数是视图名
          }
          else
            return View() ;
        }

    如果没有验证错误,便让 MVC 渲染 Thanks 视图。 如果有验证错误,则通过调用不带参数的 View 方法重新渲染 RsvpForm 视图。

    在有错误时,仅显示表单并不十分有用,还需要给用户提供一些指示,告诉他们有什么问题,以及为什么不能接受他们所递交的表单。其实现办法是在 RsvpForm 视图中使用 Html.ValidationSummary(验证摘要)辅助器方法。

    注意,在表单中输入的数据是被保留的,而且在带有验证摘要的视图被重新渲染时,这些数据会被再次显示出来。这是模型绑定特性的另一个好处,它简化了表单数据的工作。

  高亮显示无效字段:

    当模型类的某个属性验证失败时(前提是对应的属性运用了 Required 注解属性),HTML 辅助器方法会生成稍有不同的 HTML(在 input 标签内产生了一个值为 "input-validation-error" 的 class 标签属性)——通过创建样式表便可以利用这一特性,该样式表可以为这个 class 以及其他 HTML 辅助器方法所生成的 class 设置一些不同的 CSS 样式(这样就可以对不同的 class 值设置一些不同的显示效果)

    MVC 项目的约定是:将静态内容(如 CSS 样式表等)放在名称为 Content 的文件夹中(可能要自己新建)

posted on 2017-08-25 16:03  遇见未来  阅读(223)  评论(0)    收藏  举报
刷新页面返回顶部
博客园  ©  2004-2025
浙公网安备 33010602011771号 浙ICP备2021040463号-3