通过

从 .NET 8 中的 ASP.NET Core 迁移到 .NET 9 中的 ASP.NET Core

  • 项目

本文介绍如何将 .NET 8 中的 ASP.NET Core 更新为 .NET 9 中的 ASP.NET Core。

先决条件

更新 global.json 中的 .NET SDK 版本

如果依靠 global.json 文件来定向特定的 .NET Core SDK 版本，请将 version 属性更新为已安装的 .NET 9.0 SDK 版本。 例如：

{
  "sdk": {
-    "version": "8.0.100"
+    "version": "9.0.100"
  }
}

更新目标框架

将项目文件的目标框架名字对象 (TFM) 更新为 net9.0：

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

  <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net9.0</TargetFramework>
  </PropertyGroup>

</Project>

更新包引用

在项目文件中，将每个 Microsoft.AspNetCore.*、Microsoft.EntityFrameworkCore.*、Microsoft.Extensions.* 和 System.Net.Http.Json 包引用的 Version 属性更新为 9.0.0 或更高版本。 例如：

<ItemGroup>
-   <PackageReference Include="Microsoft.AspNetCore.JsonPatch" Version="8.0.2" />
-   <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="8.0.2" />
-   <PackageReference Include="Microsoft.Extensions.Caching.Abstractions" Version="8.0.0" />
-   <PackageReference Include="System.Net.Http.Json" Version="8.0.0" />
+   <PackageReference Include="Microsoft.AspNetCore.JsonPatch" Version="9.0.0-preview.1.24081.5" />
+   <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="9.0.0-preview.1.24081.2" />
+   <PackageReference Include="Microsoft.Extensions.Caching.Abstractions" Version="9.0.0-preview.1.24080.9" />
+   <PackageReference Include="System.Net.Http.Json" Version="9.0.0-preview.1.24080.9" />
</ItemGroup>

Blazor

在 .NET 9 发行之前（计划在 2024 年 11 月发行），Blazor 迁移指导将显示在此处。

其他资源