Razor kompilasi file di ASP.NET Core

Razor file dengan .cshtml ekstensi dikompilasi pada waktu build dan penerbitan Razor menggunakan SDK. Kompilasi runtime dapat diaktifkan secara opsional dengan mengonfigurasi proyek.

Catatan

Kompilasi runtime:

• Sudah usang mulai dari .NET 10.
• Tidak didukung untuk Razor komponen Blazor aplikasi.
• Tidak mendukung global menggunakan arahan.
• Tidak mendukung implisit menggunakan arahan.
• Menonaktifkan .NET Hot Reload.
• Tidak disarankan untuk skenario produksi.

Untuk skenario produksi, gunakan kompilasi build-time default. Untuk skenario pengembangan, gunakan Hot Reload. Untuk informasi selengkapnya, lihat Razor kompilasi runtime sudah usang.

Razor Kompilasi

Kompilasi Razor file build-time dan publish-time diaktifkan secara default oleh Razor SDK. Saat diaktifkan, kompilasi runtime melengkapi kompilasi build-time, memungkinkan Razor file diperbarui jika diedit saat aplikasi berjalan.

Memperbarui Razor tampilan dan Razor Halaman selama pengembangan saat aplikasi berjalan juga didukung menggunakan .NET Hot Reload.

Catatan

Razor Kompilasi runtime telah usang mulai dari .NET 10. Saat diaktifkan, kompilasi runtime menonaktifkan .NET Hot Reload. Sebaiknya gunakan Hot Reload sebagai gantinya untuk skenario pengembangan. Untuk informasi selengkapnya, lihat Razor kompilasi runtime sudah usang.

Mengaktifkan kompilasi runtime untuk semua lingkungan

Untuk mengaktifkan kompilasi runtime untuk semua lingkungan:

1. Instal Microsoft.AspNetCore.Mvc.Razor. Paket RuntimeCompilation NuGet.

2. Panggil AddRazorRuntimeCompilation di Program.cs:

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

Mengaktifkan kompilasi runtime secara kondisional

Kompilasi runtime dapat diaktifkan secara kondisional, yang memastikan bahwa output yang diterbitkan:

• Menggunakan tampilan yang dikompilasi.
• Tidak mengaktifkan pengamat file dalam produksi.

Untuk mengaktifkan kompilasi runtime hanya untuk Development lingkungan:

1. Instal Microsoft.AspNetCore.Mvc.Razor. Paket RuntimeCompilation NuGet.

2. AddRazorRuntimeCompilation Panggil Program.cs saat lingkungan saat ini diatur ke Pengembangan:

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

Kompilasi runtime juga dapat diaktifkan dengan perakitan startup hosting. Untuk mengaktifkan kompilasi runtime di Development lingkungan untuk profil peluncuran tertentu:

1. Instal Microsoft.AspNetCore.Mvc.Razor. Paket RuntimeCompilation NuGet.
2. Ubah bagian profil peluncuran environmentVariables di launchSettings.json:

   • Verifikasi bahwa ASPNETCORE_ENVIRONMENT diatur ke "Development".

   • Atur ASPNETCORE_HOSTINGSTARTUPASSEMBLIES ke "Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation". Misalnya, berikut ini launchSettings.json memungkinkan kompilasi runtime untuk profil peluncuran ViewCompilationSample dan 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"
           }
         }
       }
     }
     

Dengan pendekatan ini, tidak ada perubahan kode yang diperlukan dalam Program.cs. Pada runtime, ASP.NET Core mencari atribut HostingStartup tingkat perakitan di Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation. Atribut HostingStartup menentukan kode startup aplikasi untuk dijalankan dan kode startup tersebut memungkinkan kompilasi runtime.

Mengaktifkan kompilasi runtime untuk Razor pustaka kelas

Pertimbangkan skenario di mana Razor proyek Pages mereferensikanRazorpustaka kelas (RCL) bernama MyClassLib. RCL berisi file yang _Layout.cshtml digunakan oleh proyek MVC dan Razor Pages. Untuk mengaktifkan kompilasi runtime untuk _Layout.cshtml file di RCL tersebut Razor , buat perubahan berikut dalam proyek Pages:

1. Aktifkan kompilasi runtime dengan instruksi di Mengaktifkan kompilasi runtime secara kondisional.

2. Konfigurasikan MvcRazorRuntimeCompilationOptions di Program.cs:

   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));
   });
   

   Kode sebelumnya membangun jalur absolut ke MyClassLib RCL. PHYSICALFileProvider API digunakan untuk menemukan direktori dan file di jalur absolut tersebut. Terakhir, PhysicalFileProvider instans ditambahkan ke koleksi penyedia file, yang memungkinkan akses ke file RCL .cshtml .

Sumber Daya Tambahan:

• Properti RazorCompileOnBuild dan RazorCompileOnPublish
• Razor Arsitektur dan konsep Halaman di ASP.NET Core
• Tampilan di ASP.NET Core MVC
• ASP.NET Core Razor SDK