【第四篇】ASP.NET MVC快速入门之完整示例(MVC5+EF6)

目录

【第一篇】ASP.NET MVC快速入门之数据库操作(MVC5+EF6)

【第二篇】ASP.NET MVC快速入门之数据注解(MVC5+EF6)

【第三篇】ASP.NET MVC快速入门之安全策略(MVC5+EF6)

【第四篇】ASP.NET MVC快速入门之完整示例(MVC5+EF6

【番外篇】ASP.NET MVC快速入门之免费jQuery控件库(MVC5+EF6)

 

请关注三石的博客:http://cnblogs.com/sanshi

 

完善数据注解

到目前为止的表格页面效果:

 

我们需要更多的数据注解,来限制各个属性,以及提供显示用的名称(而不是英文字符串):

public class Student
{
       public int ID { get; set; }
 
       [Display(Name = "姓名")]
       [Required]
       [StringLength(200, MinimumLength = 2)]
       public string Name { get; set; }
       
       [Display(Name = "性别")]
       [Required]
       [Range(0, 1)]
       public int Gender { get; set; }
 
 
       [Display(Name = "所学专业")]
       [Required]
       [StringLength(200)]
       public string Major { get; set; }
 
 
       [Display(Name = "入学日期")]
       [DataType(DataType.Date)]
       [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
       public DateTime EntranceDate { get; set; }
}

 

 

再次运行,表格页面效果:

 

完善性别的显示

表格页面-性别列显示为中文

这个比较简单,将原来的:

@Html.DisplayFor(modelItem => item.Gender)

 

 

修改为:

@if (item.Gender == 1)
{
       @:男
} else
{
       @:女
}

 

 

新建编辑页面-性别显示为下拉列表

原来的编辑页面:

 

性别字段的编辑框是通过如下方式生成的:

@Html.EditorFor(model => model.EntranceDate, new { htmlAttributes = new { @class = "form-control" } })

 

 

Html辅助方法EditorFor会查看模型属性的类型,自动生成对应的表单输入框。由于性别字段是整形,所以这里默认会生成一个数字输入框。

 

为了更加友好的显示,我们将性别改为下拉列表,并且仅允许用户从下拉项中选择。首先我们需要准备下拉列表选项的集合,并通过控制器传递给视图使用:

 

定义获取性别集合的函数,由于需要多个地方使用,所以提取成一个公共方法:

private List<SelectListItem> GetGenderList()
{
       return new List<SelectListItem>() {
              new SelectListItem
              {
                     Text = "",
                     Value = "1"
              },new SelectListItem
              {
                     Text = "",
                     Value = "0"
              }
       };
}

 

 

通过ViewBag.GenderList传入视图:

// GET: Students/Edit/5
public ActionResult Edit(int? id)
{
       if (id == null)
       {
              return new HttpStatusCodeResult(HttpStatusCode.BadRequest);
       }
       Student student = db.Students.Find(id);
       if (student == null)
       {
              return HttpNotFound();
       }
 
       ViewBag.GenderList = GetGenderList();
       return View(student);
}

 

 

视图中通过DropDownListFor强类型辅助方法,来显示下拉列表以及选中项:

@Html.DropDownListFor(model => model.Gender,
ViewBag.GenderList as IEnumerable<SelectListItem>, new { @class = "form-control" })

 

 

 

表单提交时的代码和之前一样,多了一个对GetGenderList的调用:

[HttpPost]
[ValidateAntiForgeryToken]
public ActionResult Edit([Bind(Include = "ID,Name,Gender,Major,EntranceDate")] Student student)
{
       if (ModelState.IsValid)
       {
              db.Entry(student).State = EntityState.Modified;
              db.SaveChanges();
              return RedirectToAction("Index");
       }
 
       ViewBag.GenderList = GetGenderList();
       return View(student);
}

 

 

这一点非常重要,虽然正常的提交操作不会再次返回当前视图(RedirectToAction直接指定了页面跳转),但是在模型绑定失败时(尝试禁用JavaScript,姓名留空,然后提交表单),如果不重新设置ViewBag.GenderList参数就会出错:

 

表单检索

下面我们为表格页面增加一个搜索表单,用来对表格数据进行过滤。

 

先增加一些记录:

 

添加表单检索字段:

@using (Html.BeginForm())
{
    @Html.AntiForgeryToken()
    <p>
        所学专业: @Html.DropDownList("Major",
ViewBag.MajorList as IEnumerable<SelectListItem>, "全部")
        姓名: @Html.TextBox("Name")
        <input type="submit" value="检索" />
    </p>
}

 

 

由于本示例比较简单,没有单独的表来存储所学专业,因此我们需要从用户表中检索,并存储到ViewBag.MajorList中传入视图:

private List<SelectListItem> GetMajorList()
{
       var majors = db.Students.OrderBy(m => m.Major).Select(m => m.Major).Distinct();
 
       var items = new List<SelectListItem>();
       foreach(string major in majors)
       {
              items.Add(new SelectListItem {
                     Text = major,
                     Value = major
              });
       }
       return items;
}
 
// GET: Students
public ActionResult Index()
{
       ViewBag.MajorList = GetMajorList();
       return View(db.Students.ToList());
}

 

 

页面运行效果:

 

增加POST请求的处理方法:

[HttpPost]
[ValidateAntiForgeryToken]
public ActionResult Index(string Major, string Name)
{
       var students = db.Students as IQueryable<Student>;
       if (!String.IsNullOrEmpty(Name))
       {
              students = students.Where(m => m.Name.Contains(Name));
       }
 
       if (!String.IsNullOrEmpty(Major))
       {
              students = students.Where(m => m.Major == Major);
       }
 
       ViewBag.MajorList = GetMajorList();
       return View(students.ToList());
}

 

 

此时的运行效果:

 

数据库分页

分页工具条

首先改造视图代码,增加分页工具条:

<div id="pagebar">
    @for (var i = 0; i < ViewBag.PageCount; i++)
    {
        if (i == ViewBag.PageIndex)
        {
            <span class="currentpagenumber">@(i + 1)</span>
        }
        else
        {
            <a class="pagenumber" href="javascript:;">@(i + 1)</a>
        }
    }
</div>

 

 

其中ViewBag.PageIndexViewBag.PageCount是由控制器传入的分页参数,我们需要这两个数据来构造分页链接,如果是当前分页就显示为文本,如果是其他页就显示为超链接,然后通过客户端JavaScript来注册点击事件。

 

EF的数据库分页

后台控制器代码:

private static readonly int PAGE_SIZE = 3;
 
private int GetPageCount(int recordCount)
{
       int pageCount = recordCount / PAGE_SIZE;
       if (recordCount % PAGE_SIZE != 0)
       {
              pageCount += 1;
       }
       return pageCount;
}
 
private List<Student> GetPagedDataSource(IQueryable<Student> students,
int pageIndex, int recordCount)
{
       var pageCount = GetPageCount(recordCount);
       if (pageIndex >= pageCount && pageCount >= 1)
       {
              pageIndex = pageCount - 1;
       }
 
       return students.OrderBy(m => m.Name)
      .Skip(pageIndex * PAGE_SIZE)
      .Take(PAGE_SIZE).ToList();
}
 
// GET: Students
public ActionResult Index()
{
       var students = db.Students as IQueryable<Student>;
       var recordCount = students.Count();
       var pageCount = GetPageCount(recordCount);
      
       ViewBag.PageIndex = 0;
       ViewBag.PageCount = pageCount;
 
       ViewBag.MajorList = GetMajorList();
       return View(GetPagedDataSource(students, 0, recordCount));
}

 

 

EF为我们封装了大部分的细节,所以上面的数据库分页代码非常直观和容易理解:

students

       .OrderBy(m => m.Name)

       .Skip(pageIndex * PAGE_SIZE)

       .Take(PAGE_SIZE).ToList()

 

完成一个典型的数据库分页需要如下几部:

1.     OrderBy:指定排序列

2.     Skip:跳过多少条记录

3.     Take:返回的最大记录数

 

上面的OrderBy是必须指定的,否则就会报错:

 

分页SQL语句

完成上面的代码,分页效果已经出来了:

 

下面,我们使用第三方Express Profiler工具来检查EF生成的数据库分页SQL语句。

 

首先下载工具:

http://expressprofiler.codeplex.com/

 

打开Express Profiler,在Server文本框中输入(LocalDb)\MSSQLLocalDB,如果你使用的VS2013,这个字符串可能是:(LocalDb)\v11.0,点击绿色的启用按钮:

 

运行我们的示例,转到学生列表页面,然后清空Express Profiler中的全部显示,再点击第二页:

 

可以看到这里有3SQL查询,这个和我们的心理预期是一样的:

1.     第一次SQL查询:总记录数

SELECT

    [GroupBy1].[A1] AS [C1]

    FROM ( SELECT

        COUNT(1) AS [A1]

        FROM [dbo].[Students] AS [Extent1]

    )  AS [GroupBy1]

go

 

对应的C#代码:

var students = db.Students as IQueryable<Student>;

var recordCount = students.Count();

 

2.     第二次SQL查询:所学专业集合(去除重复)

SELECT

    [Distinct1].[Major] AS [Major]

    FROM ( SELECT DISTINCT

        [Extent1].[Major] AS [Major]

        FROM [dbo].[Students] AS [Extent1]

    )  AS [Distinct1]

go

 

对应的C#代码:

var majors = db.Students.OrderBy(m => m.Major).Select(m => m.Major).Distinct();

 

3.     第三次SQL查询:分页数据

SELECT

    [Extent1].[ID] AS [ID],

    [Extent1].[Name] AS [Name],

    [Extent1].[Gender] AS [Gender],

    [Extent1].[Major] AS [Major],

    [Extent1].[EntranceDate] AS [EntranceDate],

    [Extent1].[Job] AS [Job]

    FROM [dbo].[Students] AS [Extent1]

    ORDER BY [Extent1].[Name] ASC

    OFFSET 3 ROWS FETCH NEXT 3 ROWS ONLY

go

 

对应的C#代码:

return students.OrderBy(m => m.Name)

.Skip(pageIndex * PAGE_SIZE)

.Take(PAGE_SIZE).ToList();

 

这个查询顺序也和前面的EF代码的执行顺序一模一样,可以再回过头看下控制器Index方法。

 

同时处理表单检索和数据库分页

不过目前遇到点难题,我们希望实现如下两个功能:

1.     点击分页链接时会发出HTTP POST请求,在请求参数中带上表单检索值。

2.     表单检索时,在请求参数中带上当前所在的分页索引。

 

实现这两个功能才算完善,否则表单检索时如果丢失分页参数,就会回到第一页;而分页时如果丢失表单参数,就会清空表单输入框。

 

是不是开始怀念WebForms了,在WebForms中整个页面都被包含在一个表单中,因此回发时根本不需要考虑哪些参数后台需要。而MVC中这个就需要我们操心了,毕竟在灵活性的面前,便利性就会有所打折。

 

我们采取的办法是扩充前面的form标签,加入PageIndex隐藏字段,然后点击分页链接时提交表单即可:

@using (Html.BeginForm("Index", "Students", FormMethod.Post, new { id = "searchForm" }))
{
    @Html.AntiForgeryToken()
    <p>
        所学专业: @Html.DropDownList("Major",
ViewBag.MajorList as IEnumerable<SelectListItem>, "全部")
        姓名: @Html.TextBox("Name")
        <input type="hidden" id="PageIndex" name="PageIndex" value="0" />
        <input type="button" id="searchButton" value="检索" />
    </p>
}

 

 

注册JavaScript脚本来处理点击[检索]按钮和分页链接:

@section scripts {
    <script>
        function submitForm(pagenumber) {
            pagenumber = parseInt(pagenumber, 10);
            $('#PageIndex').val(pagenumber - 1);
            $('#searchForm').submit();
        }
 
        $(function () {
 
            $('#searchButton').click(function () {
                submitForm($('#pagebar .currentpagenumber').text());
            });
 
            $('#pagebar .pagenumber').click(function () {
                submitForm($(this).text());
            });
 
        });
    </script>
}

 

 

现在看下效果,首先检索所学专业:

 

然后点击第二页,会发出一个POST请求:

 

可以看到本次请求,上面的用户输入和PageIndex都发送到了控制器处理方法:

[HttpPost]
[ValidateAntiForgeryToken]
public ActionResult Index(string Major, string Name, int PageIndex)
{
       var students = db.Students as IQueryable<Student>;
       if (!String.IsNullOrEmpty(Name))
       {
              students = students.Where(m => m.Name.Contains(Name));
       }
 
       if (!String.IsNullOrEmpty(Major))
       {
              students = students.Where(m => m.Major == Major);
       }
 
 
       var recordCount = students.Count();
       var pageCount = GetPageCount(recordCount);
       if (PageIndex >= pageCount && pageCount >= 1)
       {
              PageIndex = pageCount - 1;
       }
 
       students = students.OrderBy(m=>m.Name)
            .Skip(PageIndex * PAGE_SIZE).Take(PAGE_SIZE);
 
       ViewBag.PageIndex = PageIndex;
       ViewBag.PageCount = pageCount;
 
       ViewBag.MajorList = GetMajorList();
       return View(students.ToList());
}

 

 

这里需要注意一点:先进行表单过滤,然后执行获取总记录数的查询,最后再获取分页数据。这个顺序不能变,因为表单过滤后总记录才能确定下来。

 

小结

本篇文章对示例进行了完善,首先是添加更多的数据注解,然后将显示的性别由数字改为字符串,对于编辑和新建页面,将性别渲染为下拉列表。然后为表格页面增加表单检索功能,可以根据[所学专业][姓名]对表格过滤,最后完成了数据库分页功能。

本系列文章至此已经完成了,下面我们简单总结下用到的关键词:路由引擎、控制器向视图传值、强类型辅助方法、模型绑定、数据注解、数据迁移、客户端验证、服务器端模型验证、模拟POST请求、表单身份验证、跨站请求伪造、过多提交攻击、表单检索、数据库分页。

下载示例源代码

 

posted @ 2016-12-28 09:35  三生石上(FineUI控件)  阅读(22410)  评论(19编辑  收藏  举报