ASP.NET Core 入门教程 1、使用ASP.NET Core 构建第一个Web应用

一、前言

1、本文主要内容

• Visual Studio Code 开发环境配置
• 使用 ASP.NET Core 构建Web应用
• ASP.NET Core Web 应用启动类说明
• ASP.NET Core Web 项目结构说明

2、本教程环境信息

3、前置知识

你可能需要的前置知识

• VS Code + .NET Core快速开始

https://ken.io/serie/dotnet-core-quickstart

• C#语法学习

http://www.runoob.com/csharp/csharp-tutorial.html

二、环境安装与配置

1、SDK 下载与安装

• 下载

下载地址：https://www.microsoft.com/net/download

跨平台，根据自己的需求选择即可。
这里我下载的是：SDK 2.1.401，你可以选择2.1.x的最新版本

• 安装

略，一直下一步即可，没什么需要特别注意的。
如果你真想了解，可以参考：https://ken.io/note/dotnet-core-qucikstart-helloworld-windows

2、VS Code下载&安装

• VS Code 下载

下载地址：https://code.visualstudio.com/download
反正VS Code跨平台，根据自己的需要选择就可以了，

• VS Code 安装

略，一直下一步即可，没什么特别注意的。
如果你用的macOS，直接拖动到应用程序目录即可，更简单快捷。

3、VS Code配置

• 基础扩展安装

快捷键（Ctrl+Shift+X）进入扩展管理页，直接搜索扩展名安装即可，或者点击左侧工具栏图标进入扩展管理页

macOS版本快捷键是 Shift+Commnad+X

三、VS Code 开发 ASP.NET Core Web项目

1、项目创建

• 通过命令行创建项目

#创建项目目录mkdir projects#进入项目目录cd projects#创建项目dotnet new web -n helloweb

2、VS Code打开项目

菜单：文件->打开，选择项目目录打开项目

项目打开后，VS Code会检测到缺少两个必须的Package：OmniSharp、.NET Core Debugger
并且会自动帮你安装

Downloading package ‘OmniSharp for Windows (.NET 4.6 / x64)‘ (31017 KB).................... Done!Installing package ‘OmniSharp for Windows (.NET 4.6 / x64)‘Downloading package ‘.NET Core Debugger (Windows / x64)‘ (41984 KB).................... Done!Installing package ‘.NET Core Debugger (Windows / x64)‘Finished

安装完成后VS Code会提示：

Required assets to build and debug are missing from ‘helloweb’. Add them?

选择Yes即可。

这时候，可以看一下左侧资源管理器，我们可以看到.vscode目录添加了两个配置文件：launch.json，tasks.json。
项目的编译和调试配置文件就已经准备好了

3、VS Code启动项目

我们直接按下F5，或者菜单：调试->启动调试启动项目
ASP.NET Core 默认绑定是5001端口，而且ASP.NET Core 2.1之后默认绑定了HTTPS，项目启动成功后，VS Code会帮我们打开默认浏览器并访问：https://localhost:5001

因为我们并没有配置SSL证书，所以浏览器会发出警告??，以Chrome为例：

这时候，我们点击高级，救护出现继续访问的入口

我们点击继续访问，就会出现Hello World!

4、修改绑定协议HTTPS为HTTP

接着我们可以修改配置去掉HTTPS协议绑定
打开Properties/launchSettings.json文件

{ ?"iisSettings": { ???"windowsAuthentication": false, ????"anonymousAuthentication": true, ????"iisExpress": { ?????"applicationUrl": "http://localhost:53122", ?????"sslPort": 44309 ???} ?}, ?"profiles": { ???"IIS Express": { ?????"commandName": "IISExpress", ?????"launchBrowser": true, ?????"environmentVariables": { ???????"ASPNETCORE_ENVIRONMENT": "Development" ?????} ???}, ???"helloweb": { ?????"commandName": "Project", ?????"launchBrowser": true, ?????"applicationUrl": "https://localhost:5001;http://localhost:5000", ?????"environmentVariables": { ???????"ASPNETCORE_ENVIRONMENT": "Development" ?????} ???} ?}}

iisSettings、profiles.helloweb配置节点都有启动绑定配置，因为VS Code启动项目默认是不通过IIS来host的，iisSettings选项我们忽略即可。

 "helloweb": { ?????"commandName": "Project", ?????"launchBrowser": true, ?????"applicationUrl": "http://localhost:5001", ?????"environmentVariables": { ???????"ASPNETCORE_ENVIRONMENT": "Development" ?????} ???}

将applicationUrl修改为http://localhost:5001
然后重启项目（Ctrl+Shift+F5）机会看到干净纯洁的Hello World!

5、项目启动简介

• 应用程序入口类

public class Program{ ???public static void Main(string[] args) ???{ ???????CreateWebHostBuilder(args).Build().Run(); ???} ???public static IWebHostBuilder CreateWebHostBuilder(string[] args) => ???????WebHost.CreateDefaultBuilder(args) ???????????.UseStartup<Startup>();}

在应用启动的时候，会执行CreateWebHostBuilder方法，在这个方法中通过类Startup创建了默认了HostBuilder

• 应用启动类

public class Startup{ ???ConfigureServices(IServiceCollection services) ???{ ???} ???public void Configure(IApplicationBuilder app, IHostingEnvironment env) ???{ ???????if (env.IsDevelopment()) ???????{ ???????????app.UseDeveloperExceptionPage(); ???????} ???????app.Run(async (context) => ???????{ ???????????await context.Response.WriteAsync("Hello World!"); ???????}); ???}}

web项目模板默认在项目启动的时候调用IApplicationBuilder.run方法，在当前HTTP上下文(HttpContext)中输出了Hello World！

context.Response.WriteAsync(“Hello World!”);

四、备注

1、项目结构说明

2、附录

• 本文代码示例

https://github.com/ken-io/asp.net-core-tutorial/tree/master/chapter-01

本文首发于我的独立博客：https://ken.io/note/asp.net-core-tutorial-web-helloworld

ASP.NET Core 入门教程 1、使用ASP.NET Core 构建第一个Web应用

原文地址：https://www.cnblogs.com/ken-io/p/aspnet-core-tutorial-web-helloworld.html