IHostingEnvironment VS IHostEnvironment - .NET Core 3.0中的废弃类型

本篇是如何升级到ASP.NET Core 3.0系列文章的第二篇。

Part 1 - 将.NET Standard 2.0类库转换为.NET Core 3.0类库

Part 2 - IHostingEnvironment VS IHostEnvironment - .NET Core 3.0中的废弃类型（本篇）

Part 3 - 避免在ASP.NET Core 3.0启动时注入服务

Part 4 - 将终端中间件转换为ASP.NET Core 3.0中的节点路由

Part 5 - 将集成测试的转换为NET Core 3.0

在本篇博客中，我将描述与之前版本相比，ASP.NET Core 3.0中已经被标记为废弃的类型。我将解释一下为什么这些类型被废弃了，它们的替换类型是什么，以及你应该什么时候使用它们。

ASP.NET Core与通用主机(Generic Host)合并

在ASP.NET Core 2.1中引入了新的通用主机（Generic Host), 它是借助Microsoft.Extension.*程序集来进行程序配置，依赖注入，以及日志记录来构建非HTTP应用的一种方式。 虽然这是一个相当不错的点子，但是引入主机抽象在基础上与ASP.NET Core使用的HTTP主机不兼容。这导致了多种命名空间的冲突与不兼容，所以在ASP.NET Core 2.x版本中，我一直尽量不使用通用主机。

在ASP.NET Core 3.0中，开发人员作出了巨大的努力，将Web主机与通用主机兼容起来。ASP.NET Core的Web主机现在可以作为IHostedService运行在通用主机中，重复抽象的问题（ASP.NET Core中使用一套抽象，通用主机使用另一套抽象）得到了根本解决。

当然，这还不是全部。当你从ASP.NET Core 2.x升级到3.0， ASP.NET Core 3.0并不强迫你立即使用新的通用主机。如果你愿意，你可以继续使用旧的WebHostBuilder，而不使用新的HostBuilder。虽然在ASP.NET Core 3.0的官方文档中一直暗示这是必须的，但是在当前的阶段，这是一个可选配置，如果你需要，可以继续使用Web主机，而不使用通用主机。

PS: 不过我还是建议你将可能将HostBuilder作为你未来的升级计划。我但是在未来的某个时间点WebHostBuilder将被移除，即使现在它还没有被标记为[Obsolete]。

作为重构的通用主机的一部分，一些在之前版本中重复的类型被标记为废弃了，一些新的类型被引入了。在这些类型中，最好的例子就是IHostingEnvironment。

IHostingEnvironment VS IHostEnvironment VS IWebHostEnviornment

IHostingEnvironment是.NET Core 2.x中最让人讨厌的一个接口，因为它存在于两个命名空间中, Microsoft.AspNetCore.Hosting和Microsoft.Extensions.Hosting.这两个接口有少许不同，且不兼容。

namespace Microsoft.AspNetCore.Hosting { public interface IHostingEnvironment { string EnvironmentName { get; set; } string ApplicationName { get; set; } string WebRootPath { get; set; } IFileProvider WebRootFileProvider { get; set; } string ContentRootPath { get; set; } IFileProvider ContentRootFileProvider { get; set; } } } namespace Microsoft.Extensions.Hosting { public interface IHostingEnvironment { string EnvironmentName { get; set; } string ApplicationName { get; set; } string ContentRootPath { get; set; } IFileProvider ContentRootFileProvider { get; set; } } }

之所以有两个同名接口是有历史原因的。AspNetCore版本的接口已经存在了很长时间了，在ASP.NET Core 2.1版本中，通用主机引入了Extensions版本。Extensions版本没有提供用于服务静态文件的wwwroot目录的概念（因为它承载的是非HTTP服务）。所以你可能已经注意到Extensions缺少了WebRootFileProvider和WebRootPath两个属性。

出于向后兼容的原因，这里需要一个单独的抽象。但是，这种做法真正令人讨厌的后果之一是无法编写用于通用主机和ASP.NET Core的扩展方法。

在ASP.NET Core 3.0中，上述的两个接口都已经被标记为废弃了。你依然可以使用它们，但是在编译的时候，你会得到一些警告。相对的，两个新的接口被引入进来: IHostEnvironment和IWebHostEnvironment。虽然他们出现在不同的命名空间中，但是现在它们有了不同的名字，而且使用了继承关系。

namespace Microsoft.Extensions.Hosting { public interface IHostEnvironment { string EnvironmentName { get; set; } string ApplicationName { get; set; } string ContentRootPath { get; set; } IFileProvider ContentRootFileProvider { get; set; } } } namespace Microsoft.AspNetCore.Hosting { public interface IWebHostEnvironment : IHostEnvironment { string WebRootPath { get; set; } IFileProvider WebRootFileProvider { get; set; } } }

这个层次关系更容易理解了，避免了重复，并且意味着接收通用主机版本宿主环境抽象(IHostEnvironment)的方法现在也可以接收web版本(IWebHostEnvironment)的抽象了。在幕后，IHostEnvironment和IWebHostEnvironment的实现是相同的 - 除了旧接口，他们还实现了新接口。