Razor ASP.NET Core'da dosya derleme

Razoruzantılı .cshtml dosyalar, SDK kullanılarak Razor hem derleme hem de yayımlama zamanında derlenir. Çalışma zamanı derlemesi isteğe bağlı olarak projeyi yapılandırarak etkinleştirilebilir.

Not

Çalışma zamanı derlemesi:

• Uygulama bileşenleri Blazor için Razor desteklenmez.
• Genel kullanım yönergelerini desteklemez.
• Örtük kullanım yönergelerini desteklemez.
• .NET Çalışırken Yeniden Yükleme devre dışı bırakır.
• Üretim için değil geliştirme için önerilir.

Razor derleme

Dosyaların derleme zamanı ve yayımlama zamanı derlemesi Razor , SDK tarafından Razor varsayılan olarak etkinleştirilir. Çalışma zamanı derlemesi etkinleştirildiğinde derleme zamanı derlemesini tamamlar Razor ve uygulama çalışırken düzenlendiklerinde dosyaların güncelleştirilebilmesini sağlar.

Uygulama çalışırken geliştirme sırasında görünümlerin ve Sayfaların güncelleştirilmesi Razor de .NET Çalışırken Yeniden Yükleme kullanılarak desteklenir.Razor

Not

Etkinleştirildiğinde, çalışma zamanı derlemesi .NET Çalışırken Yeniden Yükleme devre dışı bırakır. Geliştirme sırasında çalışma zamanı derlemesi Razor yerine Çalışırken Yeniden Yükleme kullanmanızı öneririz.

Tüm ortamlar için çalışma zamanı derlemesini etkinleştirme

Tüm ortamlar için çalışma zamanı derlemesini etkinleştirmek için:

1. Microsoft.AspNetCore.Mvc'yi yükleyin.Razor. RuntimeCompilation NuGet paketi.

2. çağrısıAddRazorRuntimeCompilation:Program.cs

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

Çalışma zamanı derlemesini koşullu olarak etkinleştirme

Çalışma zamanı derlemesi koşullu olarak etkinleştirilebilir ve bu da yayımlanan çıkışın şu şekilde olmasını sağlar:

• Derlenmiş görünümleri kullanır.
• Üretimde dosya izleyicilerini etkinleştirmez.

Çalışma zamanı derlemesini yalnızca Geliştirme ortamı için etkinleştirmek için:

1. Microsoft.AspNetCore.Mvc'yi yükleyin.Razor. RuntimeCompilation NuGet paketi.

2. Program.cs Geçerli ortam Geliştirme olarak ayarlandığında çağrısı AddRazorRuntimeCompilation yapma:

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

Çalışma zamanı derlemesi bir barındırma başlatma derlemesi ile de etkinleştirilebilir. Belirli başlatma profilleri için Geliştirme ortamında çalışma zamanı derlemesini etkinleştirmek için:

1. Microsoft.AspNetCore.Mvc'yi yükleyin.Razor. RuntimeCompilation NuGet paketi.
2. başlatma profilinin environmentVariables bölümünde değişiklik launchSettings.jsonyapma:

   • değerinin ASPNETCORE_ENVIRONMENT olarak ayarlandığını "Development"doğrulayın.

   • ASPNETCORE_HOSTINGSTARTUPASSEMBLIES seçeneğini "Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation" olarak ayarlayın. Örneğin, aşağıdakiler launchSettings.json ve IIS Express başlatma profilleri için çalışma zamanı derlemesini ViewCompilationSample etkinleştirir:

     {
       "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"
           }
         }
       }
     }
     

Bu yaklaşımla, içinde Program.cskod değişikliği gerekmez. çalışma zamanında, ASP.NET Core içinde Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilationderleme düzeyinde bir HostingStartup özniteliği arar. HostingStartup özniteliği yürütülecek uygulama başlangıç kodunu belirtir ve bu başlangıç kodu çalışma zamanı derlemesini etkinleştirir.

Sınıf kitaplığı için çalışma zamanı derlemesini Razor etkinleştirme

Pages projesinin MyClassLib adlı bir sınıf kitaplığına (RCL) başvurdığı Razor bir Razor senaryo düşünün. RCL, MVC ve Razor Pages projeleri tarafından kullanılan bir _Layout.cshtml dosya içerir. Bu RCL'deki dosya için çalışma zamanı derlemesini _Layout.cshtml etkinleştirmek için Sayfalar projesinde Razor aşağıdaki değişiklikleri yapın:

1. Çalışma zamanı derlemesini koşullu olarak etkinleştirme başlığındaki yönergelerle çalışma zamanı derlemesini etkinleştirin.

2. içinde Program.csyapılandırınMvcRazorRuntimeCompilationOptions:

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

   Yukarıdaki kod MyClassLib RCL için mutlak bir yol oluşturur. PhysicalFileProvider API'si, bu mutlak yolda dizinleri ve dosyaları bulmak için kullanılır. Son olarak örnek, PhysicalFileProvider RCL'nin .cshtml dosyalarına erişim sağlayan bir dosya sağlayıcıları koleksiyonuna eklenir.

Ek kaynaklar

• RazorCompileOnBuild ve RazorCompileOnPublish özellikleri
• ASP.NET Core'da Sayfalara Razor Giriş
• ASP.NET Core MVC'deki görünümler
• ASP.NET Core Razor SDK