ASP.NET Core 2.0 的 Microsoft.AspNetCore.All 元包

注意

此版本不是本文的最新版本。 对于当前版本,请参阅此文的 .NET 8 版本

警告

此版本的 ASP.NET Core 不再受支持。 有关详细信息,请参阅 .NET 和 .NET Core 支持策略。 对于当前版本,请参阅此文的 .NET 8 版本

重要

此信息与预发布产品相关,相应产品在商业发布之前可能会进行重大修改。 Microsoft 对此处提供的信息不提供任何明示或暗示的保证。

对于当前版本,请参阅此文的 .NET 8 版本

注意

Microsoft.AspNetCore.All 元包不会在 ASP.NET Core 3.0 及更高版本中使用。 有关详细信息,请参阅此 GitHub 问题

注意

对于面向 ASP.NET Core 2.1 及更高版本的应用程序,建议使用 Microsoft.AspNetCore.App 元包而不是此包。 请参阅本文中的从 Microsoft.AspNetCore.All 迁移到 Microsoft.AspNetCore.App

此功能需要面向 .NET Core 2.x 的 ASP.NET Core 2.x。

Microsoft.AspNetCore.All 是引用共享框架的元包。 共享框架是不在应用的文件夹中的一组程序集(.dll 文件)。 必须将共享框架安装在计算机上才能运行应用。 有关详细信息,请参阅共享框架

Microsoft.AspNetCore.All 引用的共享框架包括:

  • ASP.NET Core 团队支持的所有包。
  • Entity Framework Core 支持的所有包。
  • ASP.NET Core 和 Entity Framework Core 使用的内部和第三方依赖关系。

Microsoft.AspNetCore.All 包中包含了 ASP.NET Core 2.x 和 Entity Framework Core 2.x 的所有功能。 定目标到 ASP.NET Core 2.0 的默认项目模板使用此包。

Microsoft.AspNetCore.All 元包的版本号表示最低 ASP.NET Core 版本和 Entity Framework Core 版本。

以下 .csproj 文件引用了 ASP.NET Core 的 Microsoft.AspNetCore.All 元包:

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>netcoreapp2.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.All" Version="2.0.9" />
  </ItemGroup>

</Project>

隐式版本控制

在 ASP.NET Core 2.1 或更高版本中,可以指定 Microsoft.AspNetCore.All 包引用但不指定版本。 如果未指定版本,SDK 会指定隐式版本 (Microsoft.NET.Sdk.Web)。 建议使用 SDK 指定的隐式版本,而不是在包引用上显式设置版本号。 如果对这种方法有任何疑问,可以在 Microsoft.AspNetCore.App 隐式版本讨论上发表 GitHub 评论。

对于便携式应用,隐式版本设置为 major.minor.0。 共享框架前滚机制在安装的共享框架的最新兼容版本上运行应用。 为确保在开发、测试和生产中使用相同的版本,请确保在所有环境中都安装相同版本的共享框架。 对于独立应用,将隐式版本号设置为在已安装的 SDK 中捆绑的共享框架的 major.minor.patch

Microsoft.AspNetCore.All 包引用上指定版本号,不能保证会选择该共享框架版本。 例如,假设指定的版本是“2.1.1”,但安装的是“2.1.3”。 这种情况下,应用将使用"2.1.3"。 不过不建议这样做,你可以禁用前滚(修补程序和/或次要版本)。 有关 dotnet 主机前滚以及如何配置其行为的详细信息,请参阅 dotnet 主机前滚

必须在项目文件中将项目的 SDK 设置为 Microsoft.NET.Sdk.Web,这样才能使用隐式版本的 Microsoft.AspNetCore.All。 指定 Microsoft.NET.Sdk SDK(项目文件顶部的 <Project Sdk="Microsoft.NET.Sdk">)时,将生成以下警告:

警告 NU1604:项目依赖项 Microsoft.AspNetCore.All 不包括包含下限。 请在依赖项版本中包括下限,以确保一致的还原结果。

这是 .NET Core 2.1 SDK 的一个已知问题,将在 .NET Core 2.2 SDK 中修复。

从 Microsoft.AspNetCore.All 迁移到 Microsoft.AspNetCore.App

Microsoft.AspNetCore.All 包中包含以下包,而 Microsoft.AspNetCore.App 包中不包含以下包。

  • Microsoft.AspNetCore.ApplicationInsights.HostingStartup
  • Microsoft.AspNetCore.AzureAppServices.HostingStartup
  • Microsoft.AspNetCore.AzureAppServicesIntegration
  • Microsoft.AspNetCore.DataProtection.AzureKeyVault
  • Microsoft.AspNetCore.DataProtection.AzureStorage
  • Microsoft.AspNetCore.Server.Kestrel.Transport.Libuv
  • Microsoft.AspNetCore.SignalR.Redis
  • Microsoft.Data.Sqlite
  • Microsoft.Data.Sqlite.Core
  • Microsoft.EntityFrameworkCore.Sqlite
  • Microsoft.EntityFrameworkCore.Sqlite.Core
  • Microsoft.Extensions.Caching.Redis
  • Microsoft.Extensions.Configuration.AzureKeyVault
  • Microsoft.Extensions.Logging.AzureAppServices
  • Microsoft.VisualStudio.Web.BrowserLink

要从 Microsoft.AspNetCore.All 移到 Microsoft.AspNetCore.App,如果应用使用上述包或由这些包引入的包中的任何 API,请在项目中添加对这些包的引用。

不会隐式包含非 Microsoft.AspNetCore.App 依赖项的上述包的任何依赖项。 例如:

  • StackExchange.Redis 作为 Microsoft.Extensions.Caching.Redis 的依赖项
  • Microsoft.ApplicationInsights 作为 Microsoft.AspNetCore.ApplicationInsights.HostingStartup 的依赖项

更新 ASP.NET Core 2.1

建议迁移到 2.1 及更高版本的 Microsoft.AspNetCore.App 元数据包。 要继续使用 Microsoft.AspNetCore.All 元数据包并确保部署最新的补丁版本,请执行以下操作:

  • 在开发计算机和生成服务器上:安装最新的 .NET Core SDK
  • 在部署服务器上:安装最新的 .NET Core 运行时。 在应用程序重启时,应用将前滚到最新安装的版本。