ASP.NET Core中的环境配置

更新时间：2022年04月07日 09:25:46 作者：暗断肠

这篇文章介绍了ASP.NET Core中的环境配置，文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下

1.环境变量配置

ASP.NET Core在应用程序启动时读取环境变量（Properties\launchSettings.json）ASPNETCORE_ENVIRONMENT，并将该值存储在IHostingEnvironment.EnvironmentName中。ASPNETCORE_ENVIRONMENT可设置为任意值，但框架只支持三个值：Development（开发）、Staging （分阶段）和 Production（生产）。如果未设置ASPNETCORE_ENVIRONMENT，则默认为 Production。

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    if (env.IsProduction() || env.IsStaging() || env.IsEnvironment("Staging_2"))
    {
        app.UseExceptionHandler("/Error");
    }
}

Properties/launchSettings.json里面的配置如下：

当ASPNETCORE_ENVIRONMENT设置为Development时，调用UseDeveloperExceptionPage。
当ASPNETCORE_ENVIRONMENT设置为Staging、Production时，调用UseExceptionHandler。

2.开发环境配置

开发环境可以启用不应该在生产中公开的功能。例如，只在开发环境中启用了开发人员异常页。本地计算机开发环境可以在项目的Properties\launchSettings.json文件中设置。在 launchSettings.json中设置的环境值替代在系统环境中设置的值。以下 launchSettings.json 文件中显示的三个配置文件：

{
  "iisSettings": {
    "windowsAuthentication": false,
    "anonymousAuthentication": true,
    "iisExpress": {
      "applicationUrl": "http://localhost:54339/",
      "sslPort": 0
    }
  },
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_My_Environment": "1",
        "ASPNETCORE_DETAILEDERRORS": "1",
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "EnvironmentsSample": {
      "commandName": "Project",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Production"
      },
      "applicationUrl": "http://localhost:54340;http://localhost:54341"
    },
    "Kestrel Staging": {
      "commandName": "Project",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_My_Environment": "1",
        "ASPNETCORE_DETAILEDERRORS": "1",
        "ASPNETCORE_ENVIRONMENT": "Staging"
      },
      "applicationUrl": "http://localhost:51997/"
    }
  }
}

使用dotnet run启动应用时，会使用具有"commandName": "IISExpress"的第一个配置文件。commandName的值是指定要启动的Web服务器。而launchSettings.json中的applicationUrl属性也可指定服务器URL的列表。在列表中的URL之间使用分号，如上述环境配置中EnvironmentsSample里面的applicationUrl属性值配置。Visual Studio项目属性“调试”选项卡中也提供了GUI来编辑launchSettings.json文件：

在Web服务器重新启动之前，对项目配置文件所做的更改可能不会生效。必须重新启动 Kestrel才能检测到对环境配置所做的更改。
现在我们来验证开发环境中启用了开发人员异常页示例，首先调试启动第一个配置文件（IISExpress）：

3.生产环境配置

Production环境应配置为最大限度地提高安全性、性能和应用可靠性。不同于开发的一些通用设置包括：

缓存。
客户端资源被捆绑和缩小，并可能从CDN（网络分发）提供。
已禁用诊断错误页。
已启用友好错误页。
已启用生产记录和监视。例如，Application Insights。

现在我们来验证生产环境中启用了友好错误页示例，首先调试启动第二个配置文件（EnvironmentsSample）：

4.基于环境配置的Startup类和方法

当ASP.NET Core应用程序启动时，应用程序可以为不同的环境单独定义Startup类（例如，StartupDevelopment），对应Startup类会在运行时进行选择环境配置。优先考虑名称后缀与当前环境相匹配的Startup类。如果找不到匹配的Startup{EnvironmentName}，就会使用原始的Startup类。若要实现基于环境的Startup类，请为使用中的每个环境创建Startup{EnvironmentName} 类：

public class StartupDevelopment
{
    public void ConfigureServices(IServiceCollection services)
    {
    }
    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
    {
    }
}
public class StartupProduction
{
    public void ConfigureServices(IServiceCollection services)
    {
    }
    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
    {
    }
}

使用接受程序集名称的UseStartup(IWebHostBuilder, String) 进行重载：

public class Program
{
    public static void Main(string[] args)
    {
        CreateWebHostBuilder(args).Build().Run();
    }
    public static IWebHostBuilder CreateWebHostBuilder(string[] args)
    {
        var assemblyName = typeof(Startup).GetTypeInfo().Assembly.FullName;
        return WebHost.CreateDefaultBuilder(args)
            .UseStartup(assemblyName);
    }
}

通过调试启动第二个配置文件（EnvironmentsSample）看看效果：

因为调试启动第二个配置文件（EnvironmentsSample）的生产（Production）环境，所以Startup类会在运行选择时会针对当前环境配置找到对应Startup类并加载。

到此这篇关于ASP.NET Core环境配置的文章就介绍到这了。希望对大家的学习有所帮助，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

Blazor框架简介
Blazor是微软推出的基于.net平台以及http://ASP.net core技术的交互式客户Web UI框架。这篇文章为大家简单介绍了Blazor框架，需要的朋友们下面随着小编来一起学习学习吧
2022-01-01
ASP.NET中FileUpload文件上传控件应用实例
本文主要介绍FileUpload文件上传控件在实际开发中经常遇到的问题并给出解决方法，希望对大家有所帮助。
2016-04-04
ASP.NET Core命名空间System.Text.Encodings.Web介绍
这篇文章介绍了ASP.NET Core命名空间System.Text.Encodings.Web，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-01-01
Effective C# 使用成员初始化器而不是赋值语句
一般情况下，一个类都会有多个构造函数。随着时间的推移，成员变量、构造函数不断增加
2012-11-11
简单的启动窗体
简单的启动窗体...
2006-10-10
C#列出局域网中可用SQL Server服务器（续）
上一篇文章展示了使用COM对象如何列出局域网中的 SQL Server服务器信息，后来还发现在.Net中有现成的类可用，而不需要使用不太熟悉的COM对象了，这样岂不是更好？下面我把代码展示给大家：
2008-04-04
.Net Core微服务rpc框架GRPC通信基础
这篇文章介绍了.Net Core微服务rpc框架GRPC通信的基础应用，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-01-01
asp.net中MVC的处理流程详解
本文详细讲解了asp.net MVC的处理流程，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-07-07
.Net行为型设计模式之迭代器模式（Iterator）
这篇文章介绍了.Net行为型设计模式之迭代器模式（Iterator），文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2022-05-05
.Net结构型设计模式之组合模式（Composite）
这篇文章介绍了.Net结构型设计模式之组合模式（Composite），文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2022-05-05