.net core项目初建

电脑装Visual Studio2017，并升级版本。启动一个.net core 的项目。

NET Core基本介绍

1.1 什么是ASP.NET Core

ASP.NET Core 是一个全新的开源、跨平台框架，可以用它来构建基于网络连接的现代云应用程序，比如：Web 应用，IoT（Internet Of Things，物联网）应用和移动后端等。ASP.NET Core可以运行在 .NET Core 或完整的 .NET Framework 之上，其架构为发布到云端或本地运行的应用提供了一个最佳的开发框架，由开销很小的模块化组件构成，这就保持了你构造解决方案的灵活性。你可以跨平台地在Windows、Mac和Linux等设备上开发和运行你的 ASP.NET Core 应用。ASP.NET Core 的源代码已经在 GitHub上托管。

1.2 ASP.NET Core的改进

1)    在统一的方案中构建Web UI 和 Web API

2)    集成现代客户端开发框架和工作流

3)    以云就绪环境为基础的配置系统

4)    内置依赖注入

5)    全新、轻量级、模块化的HTTP请求管道

6)    在IIS或在自己托管进程中托管应用程序的能力。

7)    以.NET Core为基础，支持并行应用版本控制。

8)    完全以 NuGet 程序包方式分发

9)    一组全新的工具，简化现代Web 开发

10)  在Windows、Mac和Linux等设备上开发和运行 ASP.NET应用

11)  开放源代码和社区聚焦

1.3 ASP.NET Core 项目解读

如上图：一个ASP.NET Core应用其实就是一个简单的控制台应用程序，只是它在Main方法中创建了一个 Web 服务器而已，

using System.IO;
using Microsoft.AspNetCore.Hosting;

namespace ProgrammersLiveShow
{
    /// <summary>
    /// 系统初始化信息
    /// </summary>
    /// 修改记录：
    public class Program
    {
        public static void Main(string[] args)
        {
            var host = new WebHostBuilder()
                .UseKestrel()
                .UseContentRoot(Directory.GetCurrentDirectory())
                .UseIISIntegration()
                .UseStartup<Startup>()
                .Build();

            host.Run();
        }
    }
}

Main 使用一个遵循生成器模式的 WebHostBuilder来创建Web应用程序宿主。生成器具有定义web服务器（UseKestrel）和指定启动类（UseStartup<Startup>()）的方法。 上述示例使用的是 Kestrel Web 服务器，但你可以指定其他类型的Web 服务器。在下一节中将展示更多 UseStartup 相关的信息。WebHostBuilder 提供了大量的选项方法，包括指定宿主为 IIS 和 IIS Express 服务器的 UseIISIntegration，指定内容根目录的 UseContentRoot等。其中Build 和Run方法用于构建 IWebHost的实例，它将被用来挂载应用并开始监听到来的HTTP请求。

Startup类：

WebHostBuilder上的Startup方法用来指定你的应用程序的启动类。

该类是定义请求处理管道的地方，也是配置应用需要的服务的地方。Startup类必须是public的，而且必须包含ConfigureServices(IServiceCollection services)和Configure(IApplicationBuilder app)方法。

a)     ConfigureServices  定义应用程序中用到的服务（比如：ASP.NET MVC Core 框架，Entity Framework Core，Identity等等）

b)     Configure     定义请求处理管道中的中间件

Startup 类的 执行顺序：构造 -> configureServices->configure。

详情请参考：Startup 和 Middleware(中间件)，总结的很不错。

project.json

{
  "dependencies": {
    "Microsoft.NETCore.App": {
      "version": "1.0.0",
      "type": "platform"
    },
    "Microsoft.AspNetCore.Diagnostics": "1.0.0",
    "Microsoft.AspNetCore.Server.IISIntegration": "1.0.0",
    "Microsoft.AspNetCore.Server.Kestrel": "1.0.0",
    "Microsoft.Extensions.Logging.Console": "1.0.0"
  },
  "tools": {
    "Microsoft.AspNetCore.Server.IISIntegration.Tools": "1.0.0-preview2-final"
  },
  "frameworks": {
    "netcoreapp1.0": {
      "dependencies": {
        "Pls.Service": {
          "target": "project"
        }
      },
      "imports": [
        "dotnet5.6",
        "portable-net45+win8"
      ]
    }
  },
  "buildOptions": {
    "emitEntryPoint": true,
    "preserveCompilationContext": true
  },
  "runtimeOptions": {
    "configProperties": {
      "System.GC.Server": true
    }
  },
  "publishOptions": {
    "include": [
      "wwwroot",
      "Views",
      "appsettings.json",
      "web.config",
      "Areas",
      "nlog.config"
    ],
    "exclude": [ "bin" ]
  }
}

具体的解释请看 project.json 引用(中文版的适合英语不好的人翻翻看)。我挑几个上面用到的解释解释：

1. dependencies：依赖项，定义项目的包依赖项的一个对象，此对象的每个键是包名称，每个值包含版本信息。有关详细信息，请参阅 NuGet 文档站点上的 依赖项解析文章，类型是Object。

2. tools：定义用作当前项目工具（而不是用作引用）的包依赖项的一个对象。 此处定义的包可用于生成过程中运行的脚本，但不可访问项目自身的代码，类型是Object。

3. frameworks：框架，指定此项目支持的框架，如 .NET Framework 或通用 Windows 平台 (UWP)。 必须是有效的目标框架名字对象 (TFM)。 每个值都是一个对象，可以包含特定于此框架的信息以及以下各部分中的属性，类型是Object

4. target：限制依赖项以仅匹配 project 或 package，类型是String

5. buildOptions：其属性控制编译各个方面的一个对象。 下面列出了有效属性。 也可以按框架部分中所述目标框架进行指定，类型是Object。

6. runtimeOptions：指定在初始化期间向运行时提供的参数，类型是Object。

7. configProperties：包含用于配置运行时和框架的配置属性，类型是Object。

8. System.GC.Server：若要启用服务器垃圾回收，则为 true；否则为 false。 默认值为 false。

9. emitEntryPoint：若要创建可执行文件，则为 true；否则为 false。 默认值为 false。

10. preserveCompilationContext：若要保留引用程序集和其他上下文数据以实现运行时编译，则为 true；否则为 false。 默认值为 false。

11. publishOptions：包含编译配置的属性的一个对象，类型是 Object。

12. include：包含文件以及文件夹，类型是String 或带有通配模式的 String[]。

13. exclude：指定要从生成中排除的文件，类型是String 或带有通配模式的 String[]。