使用Visual Studio Code开发Asp.Net Core WebApi学习笔记（一）-- 起步

本文记录了在Windows环境下安装Visual Studio Code开发工具、.Net Core 1.0 SDK和开发一个简单的Web-Demo网站的全过程。

一、安装Visual Studio Code

安装文件下载地址：VS Code，当前最新版本是1.3。

推荐安装最新版，因为附带Debug插件，支持在vs code上进行断点调试。

二、安装.Net Core 1.0 SDK

安装文件下载地址：.Net Core SDK

三、创建一个.Net Core应用程序

1. 打开cmd窗口，创建一个目录，作为工程目录

2. 进入目录，使用下面三条命令初始化一个.Net Core应用程序并运行

dotnet new
dotnet restore
dotnet run

运行结果如下图。当出现Hello World!时表示应用程序已经初始化成功。

四、使用Visual Studio Code编写一个简单的Web-Demo程序

1. 使用VS Code打开上两步创建的文件夹

2. 打开project.json文件，将内容修改为如下代码片段内容

 {
   "version": "1.0.0-*",
   "buildOptions": {
     "debugType": "portable",
     "emitEntryPoint": true
   },
   "dependencies": {
     "Microsoft.NETCore.App": {
       "type": "platform",
       "version": "1.0.0"
     },
     "Microsoft.AspNetCore.Server.Kestrel": "1.0.0"
   },
   "frameworks": {
     "netcoreapp1.0": {
       "imports": "dnxcore50"
     }
   }
 }

3. 在cmd窗口执行 dotnet restore 命令更新nuget包

4. 创建Startup.cs文件，编写以下内容

 using Microsoft.AspNetCore.Builder;
 using Microsoft.AspNetCore.Hosting;
 using Microsoft.AspNetCore.Http;

 namespace WebApiFrame
 {
     public class Startup
     {
         public void Configure(IApplicationBuilder app)
         {
             app.Run(context =>
             {
                 return context.Response.WriteAsync("Hello World!");
             });
         }
     }
 }

5. 打开Program.cs文件，将内容修改为如下代码片段内容

using Microsoft.AspNetCore.Hosting;

namespace WebApiFrame
{
    public class Program
    {
        public static void Main(string[] args)
        {
            var host = new WebHostBuilder()
                .UseKestrel()
                .UseStartup<Startup>()
                .Build();

            host.Run();
        }
    }
}

五、运行调试Web-Demo应用程序

1. 切换到调试窗口，初始化调试配置文件

初始化launch.json配置文件

修改launch.json文件内容

初始化tasks.json配置文件

初次启动调试，需要配置任务运行程序，生成tasks.json配置文件

六、启动调试

再次启动调试，程序将正常运行，可以在调试控制台看到日志输出

访问默认路径：http://localhost:5000，可以看到页面显示Hello World!

到此，一个简单的Web-Demo应用程序完成了。

解释：

1. Microsoft.AspNetCore.Server.Kestrel包封装了一个名叫Kestrel的轻量Http Server，使Web应用程序可以脱离IIS进行部署运行。