ASP.NET Core 3.0 WebApi 系列【1】创建ASP.NET Core WebApi 项目

写在前面

---

C#语言可以创建RESTful服务，被称作WebApi。在这里总结学习使用支持创建、读取、更新、删除(CRUD)操作的ASP.NET Core创建RESTful服务。

一、运行环境

---

【1】运行环境：win10 家庭版
【2】开发工具：Visual Studio 2019 16.3.10
【3】开发数据库：MySql 8.0.0

二、项目搭建

---

【1】从"文件""菜单中选择"新建"> "项目"。如图所示：

【2】选择"ASP.NET Core Web"应用程序模板，再点击"下一步"。如图所示：

【3】将项目命名为.NetCoreWebApi001，然后点击"创建"。如图所示：

【4】在 ASP.NET CORE WEB 应用程序对话框中 确认选择.Net Core和ASP.NET Core 3.0。选择API模板，然后，点击创建。如图所示：

【5】自此，创建完成了一个.NET Core WebApi 。

三、测试 API

---

Ctrl+F5 运行应用。如果出现询问是否应信任 IIS Express 证书的对话框，则选择“是” 。 在接下来出现的“安全警告” 对话框中，选择“是” 。

如果，出现如下图所示：证明webApi创建成功。

四、基础知识

---

【1】appsettings.json

它是应用程序的配置文件，相当于是web.config配置文件。

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": { //例如：连接字符串
    "Mysql": "Data Source=.;Initial Catalog=NetCoreWebApi;User Id=sa;Password=123;"
  }
}

【2】Program.cs类

它是应用的托管入口点。

   //文件是应用的入口， 启动后通过UseStartup<Startup>()指定下文的Startup启动文件进行启动。
    public class Program
    {
        public static void Main(string[] args)
        {
            CreateHostBuilder(args).Build().Run();
        }

        public static IHostBuilder CreateHostBuilder(string[] args) =>
            Host.CreateDefaultBuilder(args).ConfigureWebHostDefaults(webBuilder =>
                {   //创建WebHostBuilder。
                    webBuilder.UseStartup<Startup>(); 
                    //指定启动类，用于依赖注入和中间件注册。
                });
    }
}

【3】Startup.cs 类

它是配置服务和应用的 HTTP 请求管道。

    //此文件中可以以包含服务配置、定义请求处理管道的重要操作
    public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }
        public IConfiguration Configuration { get; }
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllers();
        }
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            app.UseHttpsRedirection();
            app.UseRouting();
            app.UseAuthorization();
            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllers();
            });
        }
    }

五、写在最后

---

参考文档1

参考文档2