asp入门(手把手教你AspNetCore WebApi)

要求

前几天马给了小明和小红一个“待办”网站，小明负责后端，小红负责前端，要求网站在Windows和Linux上同时运行。

小明整理了“待办事项”的功能列表:

获取所有待办事项

按标识获取项目

添加新项目

更新现有项目

删除项目

创建网站项目

从文件菜单中选择新建>项目。

选择ASP.NET核心网络应用程序模板，然后单击下一步。

命名项目App001，然后单击创建。

在创建新的ASP.NET核心网络应用程序对话框中，确认。NET核心”和“ASP。选择NET Core 3.1”。选择应用编程接口模板，然后单击创建。

测试应用编程接口

按Ctrl+F5运行应用程序。Visual Studio启动浏览器并导航到https://localhost:/weather forecast，其中是随机选择的端口号。

到目前为止，小明已经成功创建并运行了一个WebApi项目。

项目结构

从这个图中我们可以看到，WebApi项目主要是由Program.cs、Startup.cs、appsettings.json、WeatherForecastController.cs文件组成的，所以现在我们来逐一介绍一下这些文件的主要功能。

程序类

这是所有人的入口。net核心程序并定义了两种方法:Main()和createhostbuilder()；

public class Program{    public static void Main(string[] args)    {        CreateHostBuilder(args).Build().Run();    }    public static IHostBuilder CreateHostBuilder(string[] args) =>        Host.CreateDefaultBuilder(args)            .ConfigureWebHostDefaults(webBuilder =>            {                webBuilder.UseStartup();            });}

代码并不复杂。创建一个通用主机并运行它。

启动类

它主要包括配置应用程序服务的configureServices方法和创建应用程序请求处理管道的Configure方法。

// 运行时将调用此方法。 使用此方法将服务添加到容器。public void ConfigureServices(IServiceCollection services){}// 运行时将调用此方法。 使用此方法来配置HTTP请求管道。public void Configure(IApplicationBuilder app, IWebHostEnvironment env){}

appsettings.json

Appsettings.json是内核中的一个配置文件，类似于之前ASP.NET中的web.config。

WeatherForecastController.cs

是控制器，即处理Web API请求的控制器类，从ControllerBase派生而来。

[ApiController][Route("[controller]")]public class WeatherForecastController : ControllerBase

发布到IIS

安装。视窗服务器上的核心托管捆绑包。

https://dotnet.microsoft.com/download/dotnet-core/3.1

创建IIS网站

在IIS服务器上，创建一个文件夹来包含应用程序的已发布文件夹和文件。在下一步中，文件夹路径将作为应用程序的物理路径提供给IIS。

在IIS管理器中，打开“连接”面板中的服务器节点。右键单击“站点”文件夹。在上下文菜单中选择“添加网站”。

提供网站名称，并将物理路径设置为创建的应用程序的部署文件夹。提供绑定配置，选择确定创建网站。

发布和部署应用程序

将应用程序发布到文件夹。

文件夹的内容将被移动到IIS站点的文件夹中(IIS管理器中站点的物理路径)。

总结

到目前为止，小明已经创建并运行了WebApi应用程序，并了解了WebApi项目的结构和每个文件的用途，然后将WebApi应用程序发布到IIS，可以在浏览器中访问。小明摸了摸光滑的头，打算先喝杯咖啡休息一下。