从 ASP.NET MVC 和 Web API 升级到 ASP.NET Core MVC

本文介绍如何开始将 ASP.NET MVC 项目迁移到 ASP.NET Core MVC。 在这一过程中，它突出了与 ASP.NET MVC 相关的变更。

从 ASP.NET MVC 迁移是一个多步骤过程。 本文介绍：

• 初始设置。
• 基本控制器和视图。
• 静态内容。
• 客户端依赖项。

有关迁移配置和 Identity 代码，请参阅 将配置迁移到 ASP.NET Core 和 将身份验证和 Identity 迁移到 ASP.NET Core。

Prerequisites

• 具有 ASP.NET 和 Web 开发工作负载的 Visual Studio 2019 16.4 或更高版本
• .NET Core 3.1 SDK

创建 ASP.NET MVC 的入门项目

在 Visual Studio 中创建 ASP.NET MVC 项目的示例以迁移：

1. 在“文件”菜单中，选择 “新建>项目”。
2. 选择 ASP.NET Web 应用程序（.NET Framework）， 然后选择“ 下一步”。
3. 将项目 命名为 WebApp1 ，以便命名空间与下一步中创建的 ASP.NET Core 项目匹配。 选择 创建。
4. 选择 MVC，然后选择“ 创建”。

创建 ASP.NET 核心项目

使用新的 ASP.NET Core 项目创建新解决方案，以便迁移到：

1. 启动 Visual Studio 的第二个实例。
2. 在“文件”菜单中，选择 “新建>项目”。
3. 选择 ASP.NET 核心 Web 应用程序 ，然后选择“ 下一步”。
4. 在 “配置新项目 ”对话框中，将项目 命名为 WebApp1。
5. 将位置设置为与上一个项目不同的目录，以使用相同的项目名称。 使用相同的命名空间可以更轻松地在两个项目之间复制代码。 选择 创建。
6. 在“创建新的 ASP.NET 核心 Web 应用程序 对话框中，确认已选择 .NET Core 和 ASP.NET Core 3.1。 选择 Web 应用程序（模型-View-Controller） 项目模板，然后选择“ 创建”。

将 ASP.NET 核心站点配置为使用 MVC

在 ASP.NET Core 3.0 或更高版本项目中，.NET Framework 不再是受支持的目标框架。 项目必须面向 .NET Core。 ASP.NET Core 共享框架（包括 MVC）是 .NET Core 运行时安装的一部分。 在项目文件中使用 Microsoft.NET.Sdk.Web SDK 时，会自动引用共享框架：

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

有关详细信息，请参阅 框架参考。

在 ASP.NET Core 中的 Startup 类：

• Global.asax被替换。
• 处理所有应用启动任务。

有关详细信息，请参阅 ASP.NET Core 中的应用启动。

在 ASP.NET Core 项目中，打开 Startup.cs 该文件：

public class Startup
{
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }

    // This method gets called by the runtime. Use this method to add services to the container.
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllersWithViews();
    }

    // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Home/Error");
            // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
            app.UseHsts();
        }
        app.UseHttpsRedirection();
        app.UseStaticFiles();

        app.UseRouting();

        app.UseAuthorization();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllerRoute(
                name: "default",
                pattern: "{controller=Home}/{action=Index}/{id?}");
        });
    }
}

ASP.NET 核心应用必须选择使用中间件加入框架功能。 上一个模板生成的代码添加以下服务和中间件：

• 扩展 AddControllersWithViews 方法为控制器、API 相关功能和视图注册 MVC 服务支持。 有关 MVC 服务注册选项的详细信息，请参阅 MVC 服务注册
• UseStaticFiles扩展方法添加静态文件处理程序Microsoft.AspNetCore.StaticFiles。 必须调用扩展方法 UseStaticFiles，然后才能调用 UseRouting。 有关详细信息，请参阅 ASP.NET Core 中的静态文件。
• 扩展 UseRouting 方法添加路由。 有关详细信息，请参阅 ASP.NET Core 中的路由。

此现有配置包括迁移示例 ASP.NET MVC 项目所需的内容。 有关 ASP.NET 核心中间件选项的详细信息，请参阅 ASP.NET Core 中的应用启动。

迁移控制器和视图

在 ASP.NET Core 项目中，将添加一个新的空控制器类和视图类，作为占位符，并与任何要从中迁移的 ASP.NET MVC 项目中的控制器类和视图类同名。

ASP.NET Core WebApp1 项目已包含与 ASP.NET MVC 项目相同的最小示例控制器和视图。 因此，这些将充当要从 ASP.NET MVC WebApp1 项目迁移的 ASP.NET MVC 控制器和视图的占位符。

1. 从 ASP.NET MVC HomeController 复制方法以替换新的 ASP.NET Core HomeController 方法。 无需更改动作方法的返回类型。 ASP.NET MVC 内置模板的控制器作方法返回类型为 ActionResult;在 ASP.NET Core MVC 中，作方法将改为返回 IActionResult 。 ActionResult 可实现 IActionResult。
2. 在 ASP.NET 核心项目中，右键单击 视图/Home 目录，选择“ 添加>现有项”。
3. 在 “添加现有项 ”对话框中，导航到 ASP.NET MVC WebApp1 项目的 视图/Home 目录。
4. 选择 About.cshtml“， Contact.cshtml然后 Index.cshtmlRazor 查看文件，然后选择” 添加“，替换现有文件。

有关详细信息，请参阅 在 ASP.NET Core MVC 中使用控制器处理请求 和 ASP.NET Core MVC 中的视图。

测试每个方法

可以测试每个控制器终结点，但文档中稍后将介绍布局和样式。

1. 运行 ASP.NET Core 应用。
2. 通过将当前端口号替换为 ASP.NET Core 项目中使用的端口号，从浏览器调用正在运行的 ASP.NET Core 应用上的呈现视图。 例如，https://localhost:44375/home/about。

迁移静态内容

在 ASP.NET MVC 5 或更早版本中，静态内容是从 Web 项目的根目录托管的，并与服务器端文件混合。 在 ASP.NET Core 中，静态文件存储在项目的 Web 根 目录中。 默认目录是 {content root}/wwwroot，但可以更改它。 有关详细信息，请参阅 ASP.NET Core 中的静态文件。

将 ASP.NET MVC WebApp1 项目中的静态内容复制到 wwwroot ASP.NET Core WebApp1 项目中的目录：

1. 在 ASP.NET 核心项目中，右键单击 wwwroot 目录，选择“ 添加>现有项”。
2. 在 “添加现有项 ”对话框中，导航到 ASP.NET MVC WebApp1 项目。
3. favicon.ico选择该文件，然后选择“添加”，替换现有文件。

迁移布局文件

将 ASP.NET MVC 项目布局文件复制到 ASP.NET 核心项目：

1. 在 ASP.NET 核心项目中，右键单击 Views 目录，选择“ 添加>现有项”。
2. 在 “添加现有项 ”对话框中，导航到 ASP.NET MVC WebApp1 项目的 Views 目录。
3. _ViewStart.cshtml选择该文件，然后选择“添加”。

将 ASP.NET MVC 项目共享布局文件复制到 ASP.NET 核心项目：

1. 在 ASP.NET 核心项目中，右键单击 Views/Shared 目录，选择“ 添加>现有项”。
2. 在 “添加现有项 ”对话框中，导航到 ASP.NET MVC WebApp1 项目的 Views/Shared 目录。
3. _Layout.cshtml选择该文件，然后选择“添加”，替换现有文件。

在 ASP.NET Core 项目中，打开 _Layout.cshtml 该文件。 进行以下更改以匹配如下所示的已完成代码：

更新 Bootstrap CSS 包含项，使其与下面已补全的代码相匹配：

1. 将@Styles.Render("~/Content/css")替换为<link>元素以加载bootstrap.css（请参阅下文）。
2. 删除 @Scripts.Render("~/bundles/modernizr")。

Bootstrap CSS 包含项已补全的替换标记：

<link rel="stylesheet"
    href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.css"
    integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u"
    crossorigin="anonymous">

更新 jQuery 和 Bootstrap 的 JavaScript 引入，以匹配下方已完成的代码：

1. 将@Scripts.Render("~/bundles/jquery")替换为<script>元素（请参阅下文）。
2. 将@Scripts.Render("~/bundles/bootstrap")替换为<script>元素（请参阅下文）。

JQuery 和 Bootstrap JavaScript 包含项已补全的替换标记：

<script src="https://code.jquery.com/jquery-3.3.1.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.js"
    integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>

更新后的 _Layout.cshtml 文件如下：

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>@ViewBag.Title - My ASP.NET Application</title>
    <link rel="stylesheet"
          href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.css"
          integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u"
          crossorigin="anonymous">
</head>
<body>
    <div class="navbar navbar-inverse navbar-fixed-top">
        <div class="container">
            <div class="navbar-header">
                <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
                    <span class="icon-bar"></span>
                    <span class="icon-bar"></span>
                    <span class="icon-bar"></span>
                </button>
                @Html.ActionLink("Application name", "Index", "Home", new { area = "" }, new { @class = "navbar-brand" })
            </div>
            <div class="navbar-collapse collapse">
                <ul class="nav navbar-nav">
                    <li>@Html.ActionLink("Home", "Index", "Home")</li>
                    <li>@Html.ActionLink("About", "About", "Home")</li>
                    <li>@Html.ActionLink("Contact", "Contact", "Home")</li>
                </ul>
            </div>
        </div>
    </div>
    <div class="container body-content">
        @RenderBody()
        <hr />
        <footer>
            <p>&copy; @DateTime.Now.Year - My ASP.NET Application</p>
        </footer>
    </div>

    <script src="https://code.jquery.com/jquery-3.3.1.js"></script>
    <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.js"
            integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
    @RenderSection("scripts", required: false)
</body>
</html>

在浏览器中查看站点。 它应采用部署的预期样式进行呈现。

配置打包和压缩

ASP.NET Core 与多个开源捆绑和缩小解决方案（如 WebOptimizer 和其他类似库）兼容。 ASP.NET Core 不提供本机捆绑和缩小解决方案。 有关配置捆绑和缩小的信息，请参阅 捆绑和缩小。

解决 HTTP 500 错误

有许多问题可能导致 HTTP 500 错误消息不包含有关问题源的信息。 例如，如果 Views/_ViewImports.cshtml 文件包含项目中不存在的命名空间，则会生成 HTTP 500 错误。 默认情况下，在 ASP.NET Core 应用中，当环境为开发时，扩展 会被添加到 并执行。 以下代码对此进行了详细介绍：

public class Startup
{
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }

    // This method gets called by the runtime. Use this method to add services to the container.
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllersWithViews();
    }

    // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Home/Error");
            // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
            app.UseHsts();
        }
        app.UseHttpsRedirection();
        app.UseStaticFiles();

        app.UseRouting();

        app.UseAuthorization();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllerRoute(
                name: "default",
                pattern: "{controller=Home}/{action=Index}/{id?}");
        });
    }
}

ASP.NET Core 将未经处理的异常转换为 HTTP 500 错误响应。 通常，错误详细信息不包括在这些响应中，以防止泄露有关服务器的潜在敏感信息。 有关详细信息，请参阅 开发人员异常页。

后续步骤

• <identity.md>

其他资源

• ASP.NET Core Blazor
• ASP.NET Core 中的标记帮助程序