從 ASP.NET MVC 和 Web API 升級至 ASP.NET Core MVC

本文說明如何開始將 ASP.NET MVC 專案移轉至 ASP.NET Core MVC。 在此過程中，它會突顯來自 ASP.NET MVC 的相關變更。

從 ASP.NET MVC 移轉是一個多階段的過程。 本文涵蓋：

• 初步設定。
• 基本控制器和視圖。
• 靜態內容。
• 客戶端依賴性。

如需移轉組態及程式碼，請參閱 Identity 以及 。

Prerequisites

• Visual Studio 2019 16.4 或更新版本，其中包含 ASP.NET 和網頁程式開發工作負載
• .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 Core 專案

使用新的 ASP.NET Core 專案建立新的解決方案，以移轉至：

1. 啟動 Visual Studio 的第二個實例。
2. 從 [檔案] 功能表選取 [新增]>[專案]。
3. 選取 [ASP.NET Core Web 應用程式 ]，然後選取 [ 下一步]。
4. 在 [ 設定新專案 ] 對話框中，將專案命名為 WebApp1。
5. 將位置設定為與上一個專案不同的目錄，以使用相同的項目名稱。 使用相同的命名空間可讓您更輕鬆地在兩個項目之間複製程序代碼。 選取 ，創建。
6. 在 [[建立新的 ASP.NET Core Web 應用程式] 對話框中，確認已選取 .NET Core 和 ASP.NET Core 3.1。 選取 [Web 應用程式] [模型-View-Controller] 項目範本，然後選取 [ 建立]。

將 ASP.NET Core 網站設定為使用MVC

在 ASP.NET Core 3.0 或更新版本中，.NET Framework 不再是支援的目標架構。 您的項目必須以 .NET Core 為目標。 包含MVC的 ASP.NET Core 共用架構是 .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 Core 應用程式必須選擇使用中間件加入架構功能。 先前樣本產生的程式代碼會新增下列服務和中間件：

• 擴充 AddControllersWithViews 方法會將 MVC 服務支援註冊到控制器、API 相關功能以及檢視中。 如需MVC服務註冊選項的詳細資訊，請參閱 MVC服務註冊
• 擴充 UseStaticFiles 方法會新增靜態檔案處理程式 Microsoft.AspNetCore.StaticFiles。 必須先呼叫UseStaticFiles 擴充方法，再執行UseRouting。 如需詳細資訊，請參閱 ASP.NET Core 中的靜態檔案。
• 擴充 UseRouting 方法會新增路由。 如需詳細資訊，請參閱 ASP.NET Core 中的路線規劃。

此現有組態包含移轉範例 ASP.NET MVC 專案所需的專案。 如需 ASP.NET Core 中間件選項的詳細資訊，請參閱 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 Core 專案中，右鍵點擊 Views/Home 目錄，選擇 新增>現有項目。
3. 在 [ 新增現有專案] 對話框中，流覽至 ASP.NET MVC WebApp1 專案的 Views/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 中，靜態檔案會儲存在專案的 網頁根 目錄中。 默認目錄為 {content root}/wwwroot，但可以變更。 如需詳細資訊，請參閱 ASP.NET Core 中的靜態檔案。

將 ASP.NET MVC WebApp1 專案的靜態內容複製到 ASP.NET Core wwwroot 專案的目錄：

1. 在 ASP.NET Core 專案中，右鍵點擊 wwwroot 目錄，選擇 新增>現有項目。
2. 在 [ 新增現有專案] 對話框中，流覽至 ASP.NET MVC WebApp1 專案。
3. 選擇檔案， favicon.ico 然後選擇 新增，取代現有檔案。

移轉版面配置檔案

將 ASP.NET MVC 專案設定檔複製到 ASP.NET Core 專案：

1. 在 ASP.NET Core 專案中，右鍵點擊 Views 目錄，選擇 新增>現有項目。
2. 在 [ 新增現有專案] 對話框中，流覽至 ASP.NET MVC WebApp1 項目的 Views 目錄。
3. 請先選擇_ViewStart.cshtml檔案，然後再選擇新增。

將 ASP.NET MVC 專案分享版面設定檔案複製到 ASP.NET Core 專案：

1. 在 ASP.NET Core 專案中，右鍵點擊 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 應用程式中，預設會將 UseDeveloperExceptionPage 擴充功能新增至 IApplicationBuilder，並在環境為 開發 時執行。 這在下列程式代碼中詳述：

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 核心 Blazor
• ASP.NET Core 中的標記協助程式