ASP.NET Core：CMD命令行+记事本 创建Console程序和Web Application

今天看了Scott关于ASP.NET Core的介绍视频，发现用命令行一步一步新建项目、添加Package、Restore、Build、Run 执行的实现方式，更让容易让我们了解.NET Core的运行机制。

以下是这节课的课程的笔记，给大家分享。

课程准备：

1. 安装.NET Core 运行环境，下载地址：https://www.microsoft.com/net/download
2. 安装Notepad2替代notepad，Notepad2可以识别代码、以不同的颜色进行区分，下载地址：http://www.flos-freeware.ch/notepad2.html
3. 了解几个cmd命令:

C:	打开C盘	md supermva	创建supermva文件夹
color a	命令行颜色改为绿色（更有逼格一些）	cd supermva	打开supermva文件夹
cls	清除命令行	dir	查看文件目录
cd..	返回上级目录	notepad	直接打开notepad
cd\	返回到跟目录	Tab	自动补全功能
F7	查看历史命令	exit	退出cmd

一、CMD中查看dotnet core 信息

1. >dotnet 　　          查看已安装的dotnet信息
2. >dotnet --version   查看dotnet版本
3. >dotnet --help       查看dotnet命令帮助

二、创建Console程序

1）以下步骤实现了Console输出“Hello World”，也就相当于我们在VS中 创建控制台应用程序 → 还原Nuget包 → Build → 运行

1. >md supermva                    创建supermva文件夹，
2. >cd supermva                      定位到supermva文件夹
3. >dir　　　　　　　                查看文件夹内容（此时为空）
4. >dotnet new                        查看创建dotnet程序的说明和例子
5. >dotnet new console             创建Console应用程序，supermva目录下生成了：Program.cs , supermva.csproj
6. >notepad Program.cs            打开Program.cs文件，看到Main方法中输出了“Hello World”
7. >notepad supermva.csproj    打开.csproj项目文件，看到程序的基本属性:TargetFramework
8. >dotnet restore                    还原Nuget包
9. >dotnet build                       build、complie一下
10. >dotnet run　　                   运行程序，Console输出"Hello World"

2）记事本中修改Program.cs，读取用户输入值，然后输出：

using System;

namespace supermva
{
    class Program
    {
        static void Main(string[] args)
        {
             string name;
             Console.WriteLine("Hello World!");
             name=Console.ReadLine();
             Console.WriteLine($"Hello {name}"); // 新语法
        }
    }
}

3）以上步骤的部分截图如下：

　　console程序创建成功：生成了Program.cs和.csproj项目属性文件：

　　

　　

　　build后生成了bin文件夹：

　　

　　修改Program.cs保存，dotnet run 重新运行程序：

　　

三、创建Web Application

　　web应用中，也就是用户向服务器发出HTTP请求，服务器响应然后返回给用户请求结果。

　　项目类文件中，也就需要用到AspnetCore中处理HTTP请求的功能，引用(using)对应的命名空间。

　　我们再把上面创建的Console应用程序，修改为Web应用程序。

1)  添加Nuget包： Microsoft.AspnetCore

1. > dotnet add package Micorsoft.AspnetCore
2. > notepad supermva.csproj                                打开项目属性文件，我们看到新增了对Microsoft.AspnetCore的引用
3. > dotnet restore                                                添加新的包的时候，最好restore一下
4. > dotnet build

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp1.1</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.AspnetCore" Version="1.1.1" />
  </ItemGroup>
</Project>

2）添加Startup.cs类 ，接收请求并返回数据。

• > notepad Startup.cs
• > dotnet run

这时候运行程序，还是刚才的Console输出“Hello World”。这是因为程序的入口是Main方法，还不会执行到Startup.cs类中。

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

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

3) 修改Pragram.cs中的Main方法

　　 WebHost:  宿主，Web站点寄宿的地方。

　　 Builder:    创建、建置

　　 Kestrel ： A web server for ASP.NET Core based on libuv.  这个是GitHub上对于Kestrel的定义。

　　 所以，对于这段代码的翻译就是：借助Kestrel 创建 Web Host , 把请求导向到Startup.cs类中进行处理，然后Build。

using System;
using Microsoft.AspNetCore.Hosting;
using moveToWeb; //记得添加引用

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

              host.Run();
        }
    }
}

• > dotnet run

提示：Application started, 浏览器打开，Startup.cs中输出的“Hello Web” 已经显示。

　　这样，我们就完成了Web Application的创建。

四、进一步完善Web Application

　　上面的应用，当我们在修改Startup.cs中的响应输出内容的时候，“Hello Web”→“Hello ASP.NET Core.” 点击保存，反复刷新浏览器，并没有输出我们刚刚修改的值。

　　这是因为WebHoster并不知道我们的源文件发生了变化。

　　现在我们添加一个Watcher工具，让WebHoster实时监控源文件，如果变化则自动重新Run一下，返回最新的响应信息。

1) supermva.csproj中，我们添加DotNet.Watcher工具，注意版本是：Version="1.0.0-*"

 <ItemGroup>
    <DotNetCliToolReference Include="Microsoft.DotNet.Watcher.Tools" Version="1.0.0-*" />
  </ItemGroup>

• >dotnet restore
• >dotnet build

　　Cli :Command Line Interface

2) 重新运行Web程序，在Startup.cs修改内容即时反应到了浏览器中

• >dot watch run

　　虽然没有VS简单方便，但是这样敲命令+记事本的方法新建一个Console和Web应用，可以一步一步查看每一步命令实现的功能、带来的变化。读创建过程中，CMD窗口的提示、读报错信息然后修正，这样循序渐进让我们更容易了解本质。

　　"慢即是快”, ASP.NET Core ， VS2017  Just Come On !

遇到问题：

1，Unable to load the service index for source https://api.nuget.org/v3/index.json

　　→ 可以FQ，或者把Restore命令的参数修改为Cnblogs 的 Nuget地址： > dotnet restore -s https://nuget.cnblogs.com/v3/index.json

2， 如果命令行中提示错误，看一下错误基本上能找到问题在哪里。如果添加新的Nuget包，记得再Restore一下。

MVA课程地址：

Introduction to ASP.NET Core with Visual Studio 2017

Learn what ASP.NET Core is, how to get and install it, and how to create a very quick sample application.

参考网站：

1) MVA: http://mva.microsoft.com

2) Docs : https://docs.microsoft.com

3) Net :  https://www.microsoft.com/net

4) KestrelHttpServer : https://github.com/aspnet/KestrelHttpServer/

4) Scoot Blog：http://www.hanselman.com/

5) Nuget : NuGet镜像上线试运行

本文地址：博客园 i-shanghai