ASP.NET Core 项目配置 ( Startup ) - ASP.NET Core 基础教程 - 简单教程，简单编程

2023-02-13 14:25:24

原文:ASP.NET Core 项目配置 ( Startup ) - ASP.NET Core 基础教程 - 简单教程，简单编程

ASP.NET Core 项目配置 ( Startup )

前面几章节中我们已经介绍和使用过 Startup 类，包括

在创建新项目时修改了 Startup 类中的 Hello World 修改返回值
上一章节中讲解 Program.cs 时讲到 Program 类会实例化 Startup 类

但 Startup 能做的不仅仅是这些，可以说 ASP.NET Core 中大大小小的各个组件和中间件都会和 Startup 类打交道。

但一个章节又不能全部讲完。于是乎，这章节我们只讲解最重要的几个东西

以前的版本

如果你曾经使用过 ASP.NET，那么你可能会期望

看到一个 global.asax 文件，可以在启动 Web 应用程序期间编写代码来执行的一个地方
看到一个 web.config 文件，用来包含应用程序需要执行的所有配置参数

在 ASP.NET Core 中，这些文件全部消失，取而代之的是使用 Startup.cs 加载配置和启动代码

Startup.cs 文件中有一个 Startup 类，在这个类中可以配置应用程序，甚至配置配置源

默认的 Startup.cs 文件内容

Startup.cs 文件中默认的内容如下

using System;

using System.Collections.Generic;

using System.Linq;

using System.Threading.Tasks;

using Microsoft.AspNetCore.Builder;

using Microsoft.AspNetCore.Hosting;

using Microsoft.AspNetCore.Http;

using Microsoft.Extensions.DependencyInjection;

namespace HelloWorld

{

    public class Startup

    {

        // 该方法在运行时被调用。

        // 可以使用该方法将服务添加到容器中

        // 更多信息配置应用程序的信息，可以查看 https://go.microsoft.com/fwlink/?LinkID=398940

        public void ConfigureServices(IServiceCollection services)

        {

        }

        // 该方法在运行时被调用

        // 可以使用该方法来配置 HTTP 请求管道

        public void Configure(IApplicationBuilder app, IHostingEnvironment env)

        {

            if (env.IsDevelopment())

            {

                app.UseDeveloperExceptionPage();

            }

            app.Run(async (context) =>

            {

                await context.Response.WriteAsync("Hello World!");

            });

        }

    }

}

Startup 类

Startup 类可以用来定义请求处理管道和配置应用程序需要的服务。

Startup 类必须是公开的，且必须包含以下两个方法

ConfigureServices() 方法
```
public void ConfigureServices(IServiceCollection services){}
```
ConfigureServices() 方法用于定义应用程序所需要的服务，例如 ASP.NET Core MVC 、 Entity Framework Core 和 Identity 等等

关于服务我们会再接下来的章节中详细介绍
Configure() 方法
```
public void Configure(IApplicationBuilder app, IHostingEnvironment env){}
```
Configure() 用于定义请求管道中的中间件

关于 请求管道 的概念，我们会在接下来的章节中详细介绍

项目配置

Startup 类中的 Configure() 方法用于配置和构建 HTTP 请求管道的地方

该怎么理解这句话呢？

其实也就是说，Configure() 方法可以用来定义我们的应用程序如何响应请求

对于任意网址，默认情况下它只会输出 Hello World！

ASP.NET Core 项目配置 ( Startup ) - ASP.NET Core 基础教程 - 简单教程，简单编程

如果我们希望应用程序的行为不同，我们需要在 Configure() 方法中添加其他代码来更改管道

例如，如果我们想要为诸如 index.html 之类的静态文件提供服务，则需要向 Configure() 方法添加一些代码

例如，如果想要给 ASP.NET MVC 控制器发送错误页面或路由请求，都需要在这个 Configure() 方法中做一些工作

动态响应内容

默认情况下，我们为每个请求都提供了一个硬编码的响应 Hello World!

接下里来我们不再使用硬编码，而是从某个组件中加载字符串来响应的每一个请求

在解决方案管理器的 HelloWorld 项目上点击右键，选择 添加 -> 新建文件

如果你的电脑是 Windows ，则是 添加 -> 新建项
在新建文件对话框中，选中左边的 Web，然后选中右边的 空 JSON 文件

如果你的电脑是 Windows ，则是先选中 ASP.NET Core 下的常规 ( Genreral ) 然后选中 JSON 文件
在名称中输入 AppSettings.json，然后点击右下脚的新建按钮，添加一个 AppSettings.json 文件

如果你的电脑是 Windows ，则是点击添加按钮

然后双击 AppSettings.json 打开文件，输入以下内容

{

    "message":"Hello World!\n你好，简单教程，你的网址是 www.twle.cn 吗？"

}

双击打开 Startup.cs 文件，在 Startup 类中添加一个可读写属性 Configuration
```
public IConfiguration Configuration { get; set; }
```

修改 Startup 类，添加 Startup() 构造函数，加载 AppSettings.json 文件，然后构建配置项

public Startup()

{

    var builder = new ConfigurationBuilder().AddJsonFile("AppSettings.json");

    Configuration = builder.Build();

}

最后修改 Configure() 方法，从配置项中读取 message 并作为响应的内容

public void Configure(IApplicationBuilder app, IHostingEnvironment env)

{

    if (env.IsDevelopment())

    {

        app.UseDeveloperExceptionPage();

    }

    app.Run(async (context) =>

    {

        var msg = Configuration["message"];

        await context.Response.WriteAsync(msg);

    });

}

修改完成后的代码如下

Startup.cs

using System;

using System.IO;

using System.Collections.Generic;

using System.Linq;

using System.Threading.Tasks;

using Microsoft.AspNetCore.Builder;

using Microsoft.AspNetCore.Hosting;

using Microsoft.AspNetCore.Http;

using Microsoft.Extensions.DependencyInjection;

using Microsoft.Extensions.Configuration;

namespace HelloWorld

{

    public class Startup

    {

        public Startup()

        {

            var builder = new ConfigurationBuilder()

                .SetBasePath(Directory.GetCurrentDirectory())

                .AddJsonFile("AppSettings.json");

            Configuration = builder.Build();

        }

        public IConfiguration Configuration { get; set; }

        // This method gets called by the runtime. Use this method to add services to the container.

        // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940

        public void ConfigureServices(IServiceCollection services)

        {

        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.

        public void Configure(IApplicationBuilder app, IHostingEnvironment env)

        {

            if (env.IsDevelopment())

            {

                app.UseDeveloperExceptionPage();

            }

            app.Run(async (context) =>

            {

                var msg = Configuration["message"];

                await context.Response.WriteAsync(msg);

            });

        }

    }

}

点击绿色三角形运行项目 ( 如果项目已经在运行则直接刷新浏览器即可 )

刷新浏览器，显示结果如下

ASP.NET Core 项目配置 ( Startup ) - ASP.NET Core 基础教程 - 简单教程，简单编程

码农公寓

ASP.NET Core 项目配置 ( Startup )

以前的版本

默认的 Startup.cs 文件内容

Startup 类

项目配置

动态响应内容

Startup.cs

相关文章