ASP.NET Core 中 Razor 檔案的先行編譯

副檔名為 .cshtml 的 Razor 檔案會在使用 Razor SDK 的組建和發佈時間進行編譯。 您可以透過設定專案，選擇性地啟用執行階段編譯。

注意

執行階段編譯：

• 不支援 Blazor 應用程式的 Razor 元件。
• 不支援全域引用指示詞。
• 不支援隱含引用指示詞。
• 停用 .NET 熱重新載入。
• 建議用於開發，而不是用於生產環境。

Razor 編譯

Razor SDK 預設會啟用 Razor 檔案的建置和發佈階段編譯。 啟用時，執行階段編譯可補充建置時間編譯，以允許在應用程式執行時編輯 Razor 檔案。

使用 .NET 熱重新載入也支援應用程式執行的同時，在開發期間更新 Razor 檢視和 Razor Pages。

注意

啟用時，執行階段編譯會停用 .NET 熱重新載入。 建議您在開發期間使用熱重新載入，而不是 Razor 執行階段編譯。

為所有環境啟用執行階段編譯

若要為所有環境啟用執行階段編譯：

1. 安裝 Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation NuGet 套件。

2. 在 Program.cs 中呼叫 AddRazorRuntimeCompilation：

   var builder = WebApplication.CreateBuilder(args);
   
   builder.Services.AddRazorPages()
       .AddRazorRuntimeCompilation();
   

有條件的啟用執行階段編譯

執行階段編譯可以有條件地啟用，以確保已發佈的輸出：

• 使用編譯的檢視。
• 不會在生產環境中啟用檔案監看員。

若要只針對開發環境啟用執行階段編譯：

1. 安裝 Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation NuGet 套件。

2. 當目前的環境設定為 [開發] 時呼叫 Program.cs 中的 AddRazorRuntimeCompilation：

   var builder = WebApplication.CreateBuilder(args);
   
   var mvcBuilder = builder.Services.AddRazorPages();
   
   if (builder.Environment.IsDevelopment())
   {
       mvcBuilder.AddRazorRuntimeCompilation();
   }
   

執行階段編譯也可以使用裝載啟動組件來啟用。 若要在特定啟動設定檔的開發環境中啟用執行階段編譯：

1. 安裝 Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation NuGet 套件。
2. 在 launchSettings.json 中修改啟動設定檔的 environmentVariables 區段：

   • 確認 ASPNETCORE_ENVIRONMENT 設為 "Development"。

   • 將 ASPNETCORE_HOSTINGSTARTUPASSEMBLIES 設定為 "Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation"。 例如，下列 launchSettings.json 會啟用 ViewCompilationSample 和 IIS Express 啟動設定檔的執行階段編譯：

     {
       "iisSettings": {
         "windowsAuthentication": false,
         "anonymousAuthentication": true,
         "iisExpress": {
           "applicationUrl": "http://localhost:7098",
           "sslPort": 44332
         }
       },
       "profiles": {
         "ViewCompilationSample": {
           "commandName": "Project",
           "dotnetRunMessages": true,
           "launchBrowser": true,
           "applicationUrl": "https://localhost:7173;http://localhost:5251",
           "environmentVariables": {
             "ASPNETCORE_ENVIRONMENT": "Development",
             "ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation"
           }
         },
         "IIS Express": {
           "commandName": "IISExpress",
           "launchBrowser": true,
           "environmentVariables": {
             "ASPNETCORE_ENVIRONMENT": "Development",
             "ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation"
           }
         }
       }
     }
     

使用此方法時，不需要在 Program.cs 中變更程式碼。 在執行階段中，ASP.NET Core 會在 Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation 中搜尋組件層級 HostingStartup 屬性。 屬性 HostingStartup 會指定要執行的應用程式啟動程式碼，且該啟動程式碼會啟用執行階段編譯。

啟用 Razor 類別庫的執行階段編譯

假設 Razor Pages 專案參考名為 MyClassLib 的 Razor 類別庫 (RCL)。 RCL 包含 MVC 和 Razor Pages 專案所使用的 _Layout.cshtml 檔案。 若要啟用該 RCL 中 _Layout.cshtml 檔案的執行階段編譯，請在 Razor Pages 專案中進行下列變更：

1. 使用條件式啟用執行階段編譯中的指示來啟用執行階段編譯。

2. 在 Program.cs 中設定 MvcRazorRuntimeCompilationOptions：

   var builder = WebApplication.CreateBuilder(args);
   
   builder.Services.AddRazorPages();
   
   builder.Services.Configure<MvcRazorRuntimeCompilationOptions>(options =>
   {
       var libraryPath = Path.GetFullPath(
           Path.Combine(builder.Environment.ContentRootPath, "..", "MyClassLib"));
   
       options.FileProviders.Add(new PhysicalFileProvider(libraryPath));
   });
   

   上述程式碼會建置 MyClassLib RCL 的絕對路徑。 PhysicalFileProvider API 可用來找出位於該絕對路徑的目錄和檔案。 最後，PhysicalFileProvider 執行個體會新增至檔案提供者集合，以允許存取 RCL 的 .cshtml 檔案。

其他資源

• RazorCompileOnBuild 和 RazorCompileOnPublish 的屬性
• ASP.NET Core 中的 Razor Pages 簡介
• ASP.NET Core MVC 中的檢視
• ASP.NET Core Razor SDK