ASP.NET Core教程【一】关于Razor Page的知识

关键文件和目录结构

按照asp.net core WEB应用程序向导,创建一个工程之后

你会发现如下几个目录和文件

  • wwwroot:放置网站的静态文件的目录
  • Pages:放置razor页面的目录
  • appsettings.json:是应用的配置文件
  • bower.json:静态资源包管理的配置文件
  • Program.cs:这个程序负责承载ASP.NET Core应用
  • Startup.cs:初始化service的配置,初始化请求管道

下面我们单独说一下Pages目录

_Layout.cshtml 是整个网站的母板文件,

除了在这里写布局页面的代码外,

你还可以把一些基础的样式和脚本放在这里,

_ViewStart.cshtml 负责设置所有Razor页面都会用到的Layout属性,

_ViewImports.cshtml 负责设置所有页面都会用到的指令,比如引入什么类库等

_ValidationScriptsPartial.cshtml 负责引用验证脚本,比如jquery的validation组件

数据库链接字符串放在哪儿

在appsettings.json文件中,你可以防止数据库链接字符串,比如这样:

 {
  "Logging": {
    "IncludeScopes": false,
    "LogLevel": {
      "Default": "Warning"
    }
  },
  "ConnectionStrings": {
    "MovieContext": "Server=(localdb)\\mssqllocaldb;Database=Movie-1;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

ConnectionStrings就是数据库链接字符串;

在Startup中依赖注入数据库链接上下文对象

在Startup.cs文件中,有一个ConfigureServices方法,你可以通过依赖注入的方式,加载数据库连接上下文,比如这样:

public void ConfigureServices(IServiceCollection services)
{
    // 需要引用如下两个类库
    // using RazorPagesMovie.Models;
    // using Microsoft.EntityFrameworkCore;

    services.AddDbContext<MovieContext>(options =>
        options.UseSqlServer(Configuration.GetConnectionString("MovieContext")));
    services.AddMvc();
}

说明:这里用到了Microsoft.EntityFrameworkCore,要先通过nuget包管理器,引入包,相关内容不作赘述;

接下来你就可以写实体,完成相应数据的增删改查了;

数据库表结构同步工具

往往我们写了实体类型,还需要把实体类型做成数据库结构,非常麻烦

这里你可以用microsoft.visualstudio.web.codegeneration.design,这个包来完成相应的工作,相关的命令如下:

Install-Package Microsoft.VisualStudio.Web.CodeGeneration.Design -Version 2.0.0
Add-Migration Initial
Update-Database

第一行是安装这个工具包;

第二行是根据DbContext所引用的实体类,生成数据库表结构的同步代码;

第三行是更新数据库;

这个工具包是不是只支持EF,还有待考察。

Razor页面的PageModel类

好,我们现在看看怎么通过数据库上下文把数据从数据库中拿出来

在Pages目录下,创建一个Razor页面

在相应的cshtml.cs文件中,撰写如下代码:

using Microsoft.AspNetCore.Mvc.RazorPages;
using Microsoft.EntityFrameworkCore;
using System.Collections.Generic;
using System.Threading.Tasks;
using RazorPagesMovie.Models;


namespace RazorPagesMovie.Pages.Movies
{
    public class IndexModel : PageModel
    {
        private readonly RazorPagesMovie.Models.MovieContext _context;

        public IndexModel(RazorPagesMovie.Models.MovieContext context)
        {
            _context = context;
        }

        public IList<Movie> Movie { get;set; }

        public async Task OnGetAsync()
        {
            Movie = await _context.Movie.ToListAsync();
        }
    }
}

说明:Movie是与数据库表结构对应的实体类;

Razor页面继承自PageModel类,按照约定,类名遵从[PageName]Model这样的命名方式

构造函数通过依赖注入获得数据库访问上下文实例;

关于Razor Page的页面代码

我们再来看看.cshtml文件的代码:

@page
@model RazorPagesMovie.Pages.Movies.IndexModel

@{
    ViewData["Title"] = "Index";
}

<h2>Index</h2>

<p>
    <a asp-page="Create">Create New</a>
</p>
<table class="table">
    <thead>
        <tr>
            <th>
                @Html.DisplayNameFor(model => model.Movie[0].Title)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.Movie[0].ReleaseDate)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.Movie[0].Genre)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.Movie[0].Price)
            </th>
            <th></th>
        </tr>
    </thead>
    <tbody>
@foreach (var item in Model.Movie) {
        <tr>
            <td>
                @Html.DisplayFor(modelItem => item.Title)
            </td>
            <td>
                @Html.DisplayFor(modelItem => item.ReleaseDate)
            </td>
            <td>
                @Html.DisplayFor(modelItem => item.Genre)
            </td>
            <td>
                @Html.DisplayFor(modelItem => item.Price)
            </td>
            <td>
                <a asp-page="./Edit" asp-route-id="@item.ID">Edit</a> |
                <a asp-page="./Details" asp-route-id="@item.ID">Details</a> |
                <a asp-page="./Delete" asp-route-id="@item.ID">Delete</a>
            </td>
        </tr>
}
    </tbody>
</table>

Razor引擎可以把上面这些HTML代码转成C#代码或者转成Razor过度代码;

当一个 @ 符号后面跟的是Razor保留关键字的话,他会被转义成Razor过度代码,否则会被转义成C#代码;

这是在编译期完成的工作,所以不会影响运行期的执行效率;

关于page指令

@page指令使得这个页面变成了一个ASP.NET MVC的Action

这个指令必须是在Razor Page的第一个指令

关于违法访问的处理

来看看下面这行代码:

@Html.DisplayNameFor(model => model.Movie[0].Title))

这行代码的特殊之处在于,不会存在违法访问的异常,

也就是说model, model.Movie 和model.Movie[0] 的值是 null 或者empty时,不会报异常;

关于model指令

@model RazorPagesMovie.Pages.Movies.IndexModel

这个指令使得cshtml.cs文件中的IndexModel类,在这个Razor Page中有效

关于ViewData

@page
@model RazorPagesMovie.Pages.Movies.IndexModel

@{
    ViewData["Title"] = "Index";
}

你可以在Razor Page页面中设置ViewData的键值,在_Layout.cshtml模版页面中使用你设置的ViewData

关于注释

在Razor Page中,用下面的方式写注释

@*这里是注释*@

关于全局的模版页设置

在_ViewStart.cshtml文件中,我们为所有的页面设置了母板页,代码如下:

@{
    Layout = "_Layout";
}

注意,在这里我们并没有详细讲链接标签: asp-page="./Edit" asp-route-id="@item.ID"

以后的文章里我们会说到!

上一篇:3D图像渲染必备控件threed32.ocx


下一篇:记录一次Debug Assertion Failed!