ASP.NET Core系列（二）：创建第一个.Net Core 项目
前面讲过 .NET Core简介及开发环境安装，本章会讲一讲ASP.NET Core 2.0的项目结构，查看完整的ASP.NET Core系列文章：https://www.cnblogs.com/zhangweizhong/category/1477144.html
新建项目
新建项目, 选择.NET Core 有如下几种类型可选, 分别是Console， ASP.NET Core 的空项目，Web API
我们选择ASP.NET Core Web App(MVC), 没有标注MVC的是采用Razor pages 的项目。
项目结构图
新建的项目结构如下图所示, 大体上和ASP.NET 的Framework版本差不多, Controller、Model, View就不介绍了。
大概介绍一下各个文件是干什么用的，后面的文章会做详细的研究。
launchSettings.json
顾名思义, 这是 json格式的启动配置文件，如下图所示：
{
"iisSettings": {
"windowsAuthentication": false,
"anonymousAuthentication": true,
"iisExpress": {
"applicationUrl": "http://localhost:9452",
"sslPort": 44379
}
},
"profiles": {
"IIS Express": {
"commandName": "IISExpress",
"launchBrowser": true,
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
},
"MyFirstCore": {
"commandName": "Project",
"launchBrowser": true,
"applicationUrl": "https://localhost:5001;http://localhost:5000",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
}
}
}
图的上部分对应json中的profiles中定义的两种配置,分别以IIS Express。基本上都是Web服务器比如URL、身份认证以及SSL等配置。
wwwroot
wwwroot它包含了所有的”前端”的静态文件, css、image、JS以及一个名为lib的文件夹。
lib中默认内容是bootstrap和jquery。
在Startup中，会调用UseStaticFiles()方法, 将此目录标记到网站根目录。
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
//.....
app.UseStaticFiles();
//.....
}
具体静态文件的路径及相关自定义配置, 授权等后文详细研究。
依赖项
整个项目依赖引用的类库，这里主要分两部分, NuGet和SDK, 目前这两部分下面都只有一项.
Nuget:
包含Microsoft.AspNetCore.App, 展开它看一下, 里面MVC、Razor、EF以及SQLLite都要,
它包含了
- ASP.NET Core 团队支持的所有包。
- Entity Framework Core 支持的所有包。
- ASP.NET Core 和 Entity Framework Core 使用的内部和第三方依赖关系。
这里面是完整的AspNetCore的类库，其实这些程序集不会随着项目发布一起出现在部署包中, 不止没引用的, 包括引用的也不会. 这些已经存在于部署环境中了, 所以发布包不会变大反而会变小, 不必担心.
SDK:
SDk中包含了一项: Microsoft.NETCore.App, 它是.NET Core 的部分库。 也就是 .NETCoreApp 框架。 它依赖于更小的 NETStandard.Library。
相对于上面的Microsoft.AspNetCore.App, 它同样是包含了一些程序集.但它似乎更”基础”一些.
二者异同
Microsoft.AspNetCore.App中大部分都是Microsoft.开头的一些程序集, 而Microsoft.NETCore.App中出现的大多数是我们熟悉的system.XXX的.
二者的关系就像ASP.NET相对于.NET, 此处是Asp.NetCore相对于.Net Core.
SDK同样是一个大而全的集和, 在部署的时候, SDK中的引用依然不会出现在部署包中。
appsettings.json
这就是原来的framework版本的MVC的Web.config文件，里面会配置系统相关的所有的配置项，比如数据库连接等。
默认情况appsettings.json只有对于log日志的相关配置。这里就不一一说明了。
{
"Logging": {
"LogLevel": {
"Default": "Warning"
}
},
"AllowedHosts": "*"
}
Program.cs
public class Program
{
public static void Main(string[] args)
{
BuildWebHost(args).Run();
}
public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
WebHost.CreateDefaultBuilder(args)
.UseStartup<Startup>()
}
这里是简单的Main方法, 也就是应用的启动的入口, 启动后通过UseStartup<Startup>()指定下文的Startup启动文件进行启动。
Startup.cs
这是Mvc Core非常重要的地方, 包括加载配置, 通过依赖注入加载组件, 注册路由等都在此处进行。
默认的代码中：
public class Startup
{
public Startup(IConfiguration configuration)
{
Configuration = configuration;
}
public IConfiguration Configuration { get; }
// This method gets called by the runtime. Use this method to add services to the container.
public void ConfigureServices(IServiceCollection services)
{
services.Configure<CookiePolicyOptions>(options =>
{
// This lambda determines whether user consent for non-essential cookies is needed for a given request.
options.CheckConsentNeeded = context => true;
options.MinimumSameSitePolicy = SameSiteMode.None;
});
services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
}
// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
else
{
app.UseExceptionHandler("/Home/Error");
app.UseHsts();
}
app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseCookiePolicy();
app.UseMvc(routes =>
{
routes.MapRoute(
name: "default",
template: "{controller=Home}/{action=Index}/{id?}");
});
}
}
如上图所示, 默认情况下设置了两种不同状态下的错误页, 指定静态文件并且设置了路由。
在这里, 我们可以向管道中通过中间件的方式插入我们需要的工作内容。
比如我们还可以用app.UseAuthentication()来做身份验证。
我们使用 Use、Run 和 Map 来配置 HTTP 管道。
Use 方法可使管道短路（即不调用 next 请求委托）。
Run 是一种约定，并且某些中间件组件可公开在管道末尾运行的 Run[Middleware] 方法。
Map* 扩展用作约定来创建管道分支。
此处涉及内容非常多, 比如管道机制、路由注册、身份认证等都需要专题研究。
小结
项目的结构大体就是这样，主要功能介绍完了，后面会一个一个详细介绍各自的功能和作用。