从零开始构建一个的asp.net Core 项目

Posted 2020-09-17 小曲isme

接着上一篇博客继续进行。上一篇博客只是显示了简单的MVC视图页，这篇博客接着进行,连接上数据库，进行简单的CRUD。

首先我在Controllers文件夹点击右键，添加->控制器 弹出的对话框中选择miniual Dependencies。在项目的根目录下添加一个Models文件夹，在该文件夹下添加一个Users.cs类。（该类在数据库中对应一张表，表名为Users 里边有三个字段 其中ID是主键，自增的。）

    public class Users
    {
        [Key]
        public int Id { get; set; }
        public string Name { get; set; }
        public string pwd { get; set; }
    }

Users.cs

我再次在Controlles文件夹上点击右键 ，添加->控制器，在弹出的对话框中选择 视图使用Entity Framework 的MVC控制器 模型类选择我刚刚添加的那个Users.cs类，在数据上下文选项中，我选择了新建一个名称为UsersContext.cs 之后点击完成。

系统会给我报错，错误内容为 “No executeable found matching command "dotnet-aspnet-codegenerator”，昨天和今天都困在了这个错误上边，今天下午突然想到，在系统为我生成的带MVC视图页的项目都没有报错，可以正常使用。于是我点开了项目的*.csproj文件，结果发现他比我多了这样的一行代码。

 <ItemGroup>
    <DotNetCliToolReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Tools" Version="1.0.0" />
  </ItemGroup>

于是我把这行代码加进了我的*.csproj文件中去。加进去之后我发现可以了，那个错误解决了。突然之间觉得这个代码好熟悉，应该是在微软的asp.net core 官方说明文档上见过，今天想查一下，这行代码什么作用，可是找了一下，一时间没有找到。

我再次重复在Controlles文件夹上点击右键 ，添加->控制器，在弹出的对话框中选择 视图使用Entity Framework 的MVC控制器 模型类选择我刚刚添加的那个Users.cs类，在数据上下文选项中，我选择了新建一个名称为UsersContext.cs 之后点击完成。

接着系统又给我报了另一个错误 （如图），不过这个错误就明显了，说的大致内容就是“基架编辑StrartUp.cs这个类用DI去注册一个新的Context失败....”

到了这里我想到了，我在添加mini Dependencies 控制器时系统为我生成的一个阅读文件 “ScaffoldingReadMe.txt”，

ASP.NET MVC core dependencies have been added to the project.
However you may still need to do make changes to your project.

1. Suggested changes to Startup class:
    1.1 Add a constructor:
        public IConfigurationRoot Configuration { get; }

        public Startup(IHostingEnvironment env)
        {
            var builder = new ConfigurationBuilder()
                .SetBasePath(env.ContentRootPath)
                .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
                .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true)
                .AddEnvironmentVariables();
            Configuration = builder.Build();
        }
    1.2 Add MVC services:
        public void ConfigureServices(IServiceCollection services)
        {
            // Add framework services.
            services.AddMvc();
       }

    1.3 Configure web app to use use Configuration and use MVC routing:

        public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
        {
            loggerFactory.AddConsole(Configuration.GetSection("Logging"));
            loggerFactory.AddDebug();

            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            else
            {
                app.UseExceptionHandler("/Home/Error");
            }

            app.UseStaticFiles();

            app.UseMvc(routes =>
            {
                routes.MapRoute(
                    name: "default",
                    template: "{controller=Home}/{action=Index}/{id?}");
            });
        }

ScaffoldingReadMe.txt

于是我打开了这个文件，上边的内容说的很清楚让我配置Startup.cs 文件于是我按照上边进行一步步的配置了。直接粘贴就可以。我查看了一下我的跟目录下没有appsettings.json文件，于是我自己添加了这个ASP .NET配置文件，接下来就就可以顺利的进行了。

添加了试图页，修改了数据库的连接字符串。这样基本都完成了。

演示效果如下：

由于是从零开始构建，既然是从零开始，我要搞清楚系统为我生成了什么东西，以及这些东西怎么用。

我点开了*.csproj文件发现用EF的时候系统我们添加了这些的引用。

1     <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="1.1.1" />
2     <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="1.1.1" />
3     <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer.Design" Version="1.1.1" />
4     <PackageReference Include="Microsoft.Extensions.Logging.Debug" Version="1.1.1" />
5     <PackageReference Include="Microsoft.VisualStudio.Web.BrowserLink" Version="1.1.0" />
6     <PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="1.1.0" />

 我依次查了对应包的描述说明

1. ”Shared design-time components for Entity Framework Core tools. “应该就是一个组件，配合EF框架使用的。

2.“Microsoft SQL Server database provider for Entity Framework Core.”

3.“Design-time Entity Framework Core Functionality for Microsoft SQL Server.” 由于我用的是Sql Server 的数据库，所以第二和三这两个包应该是EF连数据必须用的

4.“Debug output logger provider implementation for Microsoft.Extensions.Logging. This logger logs messages to a debugger monitor by writing messages with System.Diagnostics.Debug.WriteLine()”  这个应该是我们在StartUp.cs类中添加的 

  loggerFactory.AddDebug();  

这行代码用到的，具体作用就是将运行过程中调试的错误给输出来。

5.“A middleware that supports creating a communication channel between the development environment and one or more web browsers.”这个包的作用我猜测：在我们下断点调试的时侯用到的

6.”Code Generation tool for ASP.NET Core. Contains the dotnet-aspnet-codegenerator command used for generating controllers and views.“这个包包含了一个命令 “dotnet-aspnet-codegenerator” 以后如果用EF的时候出现无法识别“dotnet-aspnet-codegenerator”命令错误 那就是没有加这个包。包的作用就是生成控制器和对应的视图。

我点开了系统为我添加的Data文件夹，里边有一个*context.cs类从名字上可以看出这是一个数据上下文的类，在我们的*Controller.cs 中有一个静态的只读字段就是它，既然点开了*Contrllers.cs类，我就看看这个类里边有什么。除了几个View对应的action 还有一个构造函数，用于对*context.cs类进行初始化。我不禁想这个构造函数在哪里用了，以及怎么初始化了？ 我用反编译工具也没又找到。于是放了下来。

我点开了StartUp.cs 这个类。除了我们先前配置的那些东西之外，EF为我们添加了一个服务

1   public void ConfigureServices(IServiceCollection services)
2         {
3             services.AddMvc();
4             //下边这是EF为我们添加的
5             services.AddDbContext<UsersContext>(options =>
6                     options.UseSqlServer(Configuration.GetConnectionString("UsersContext")));
7    
8         }

这个服务就是配置了EF连接数据库所用的一个上下文，以及声明了连接的数据库类型是sqlserver，连接数据库的字符串是“UsersContext”里边的值。

UsersContext这个字符串  在我们用EF之前在Startup.cs类中配置的构造函数中声明的。

        public IConfigurationRoot Configuration { get; }

        public Startup(IHostingEnvironment env)
        {
            var builder = new ConfigurationBuilder()
                .SetBasePath(env.ContentRootPath)
                .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
                .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true)
                .AddEnvironmentVariables();
            Configuration = builder.Build();
        }

在这里我们设置了路径为我们当前运行环境的根目录，读取的json文件名为“appsettings.json”，最后把它给了赋值给了Configurtation这个属性。

所以我们在那里才能够找到UsersContext里边的值。

我点开了Views下的share文件夹，发现还有一个生成的文件 _ValidationScriptsPartial.cshtml

 1 <environment names="Development">
 2     <script src="~/lib/jquery-validation/dist/jquery.validate.js"></script>
 3     <script src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.js"></script>
 4 </environment>
 5 <environment names="Staging,Production">
 6     <script src="https://ajax.aspnetcdn.com/ajax/jquery.validate/1.14.0/jquery.validate.min.js"
 7             asp-fallback-src="~/lib/jquery-validation/dist/jquery.validate.min.js"
 8             asp-fallback-test="window.jQuery && window.jQuery.validator">
 9     </script>
10     <script src="https://ajax.aspnetcdn.com/ajax/jquery.validation.unobtrusive/3.2.6/jquery.validate.unobtrusive.min.js"
11             asp-fallback-src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js"
12             asp-fallback-test="window.jQuery && window.jQuery.validator && window.jQuery.validator.unobtrusive">
13     </script>
14 </environment>

_ValidationScriptsPartial.cshtml

这个应该就是model的验证。里边需要引用js文件。我这里没有使用验证，所以我也就没有加上相应的js文件。

其实验证很简单的，比如我上边的Users.cs类中为name加上一个特性 [Required(ErrorMessage = "不能为空")]，在前台的添加用户界面中的输入框标签加上一个“asp-validation-for="Name"” 这样当你点击确定时，如果这个输入框为空时系统会给提示，效果如下：

” The validation attributes are checked on the client side before values are posted to the server, as well as on the server before the controller action is called.“这是微软关于验证的说明。也就是双向的。

关于自定义双向验证。可以看一下这篇博客 http://www.cnblogs.com/dudu/p/6812715.html

到了这里系统为我们生成的东西基本都在这里了。可以连接上数据库进行CRUD了。基本到这里就要告一个段落了。