ASP.NET Core Razor SDK

Gönderen Rick Anderson

Genel bakış

.NET 6.0 SDK'sı MSBuild SDK'sını Microsoft.NET.Sdk.Razor (Razor SDK) içerir. The Razor SDK:

• ASP.NET Core MVC tabanlı veya projelerin dosyalarını içeren Razor projeleri derlemek, paketlemek ve Blazor yayımlamak için gereklidir.
• Önceden tanımlanmış bir özellik kümesi ve (.cshtml veya .razor) dosyalarının Razor derlenmesini özelleştirmeye olanak sağlayan öğeler içerir.

SDK, Razor ve **\*.razor globbing desenlerine ayarlanmış **\*.cshtml öznitelikleri olan Include öğeler içerirContent. Eşleşen dosyalar yayımlanır.

Önkoşullar

.NET 6.0 SDK

SDK'yi Razor kullanma

Çoğu web uygulamasının SDK'ya açıkça başvurması Razor gerekmez.

SDK'yı Razor kullanarak görünümler veya Razor Sayfalar içeren Razor sınıf kitaplıkları oluşturmak için sınıf kitaplığı (RCL) proje şablonuyla Razor başlamanızı öneririz. En az sayıda dosya oluşturmak Blazor (.razor) için kullanılan bir RCL için Microsoft.AspNetCore.Components paketine başvuru yapılması gerekir. Görünümler veya sayfalar (.cshtmldosyalar) oluşturmak Razor için kullanılan bir RCL en az hedefleme netcoreapp3.0 veya sonraki bir sürümü gerektirir ve FrameworkReference proje dosyasındaki Microsoft.AspNetCore.App meta paketine sahiptir.

Properties

Aşağıdaki özellikler, proje derlemesinin Razorbir parçası olarak 'nin SDK davranışını denetler:

• RazorCompileOnBuild: olduğunda true, derlemeyi Razor derler ve projeyi oluşturmanın bir parçası olarak yayar. varsayılan değeridir true.
• RazorCompileOnPublish: olduğunda true, derlemeyi Razor derler ve projeyi yayımlamanın bir parçası olarak yayar. varsayılan değeridir true.
• UseRazorSourceGenerator: varsayılan değeridir true. Zamanı: true
  • Kaynak oluşturma kullanarak derler.
  • oluşturmaz <app_name>.Views.dll. Görünümler içinde <app_name>.dllbulunur.
  • .NET Çalışırken Yeniden Yükleme destekler.

Aşağıdaki tabloda yer alan özellikler ve öğeler, SDK'ya yönelik girişleri ve çıktıları yapılandırmak için Razor kullanılır.

Items	Açıklama
RazorGenerate	Kod oluşturma işlemine giriş olan öğe öğeleri (.cshtml dosyalar).
RazorComponent	Bileşen kodu oluşturma işlemine Razor giriş olan öğe öğeleri (.razordosyalar).
RazorCompile	Derleme hedeflerine Razor giriş olan öğe öğeleri (.csdosyalar). Derlemede Razor derlenecek ek dosyaları belirtmek için bunu ItemGroup kullanın.
RazorEmbeddedResource	Oluşturulan Razor derlemeye ekli kaynaklar olarak eklenen öğe öğeleri.

Özellik	Açıklama
RazorOutputPath	Çıkış Razor dizini.
RazorCompileToolset	Derlemeyi derlemek için kullanılan araç takımını Razor belirlemek için kullanılır. Geçerli değerler: Implicit, RazorSDK ve PrecompilationTool.
EnableDefaultContentItems	Varsayılan true değeridir. olduğundatrue, projede içerik olarak web.config, .jsonve .cshtml dosyaları içerir. aracılığıyla Microsoft.NET.Sdk.Webbaşvurulduğunda, wwwroot ve yapılandırma dosyaları altındaki dosyalar da eklenir.
EnableDefaultRazorGenerateItems	olduğundatrue, öğelerdeki RazorGenerate öğelerdeki Content dosyaları içerir.cshtml.
GenerateRazorTargetAssemblyInfo	.NET 6 ve sonraki sürümlerde kullanılmaz.
EnableDefaultRazorTargetAssemblyInfoAttributes	.NET 6 ve sonraki sürümlerde kullanılmaz.
CopyRazorGenerateFilesToPublishDirectory	olduğundatrue, öğeleri (.cshtml) dosyaları yayımlama dizinine kopyalarRazorGenerate. Derleme zamanında veya yayımlama zamanında derlemeye katılan dosyalar genellikle Razor yayımlanmış bir uygulama için gerekli değildir. varsayılan değeridir false.
PreserveCompilationReferences	olduğunda true, başvuru derleme öğelerini yayımlama dizinine kopyalayın. Derleme derleme zamanında veya yayımlama zamanında gerçekleşirse Razor , genellikle yayımlanmış bir uygulama için başvuru derlemeleri gerekli değildir. true Yayımlanan uygulamanız çalışma zamanı derlemesi gerektiriyorsa olarak ayarlayın. Örneğin, uygulama çalışma zamanında dosyaları değiştirirse veya eklenmiş görünümler .cshtml kullanıyorsa değerini true olarak ayarlayın. varsayılan değeridir false.
IncludeRazorContentInPack	olduğunda true, tüm Razor içerik öğeleri (.cshtml dosyalar) oluşturulan NuGet paketine dahil edilmek üzere işaretlenir. varsayılan değeridir false.
EmbedRazorGenerateSources	olduğunda true, RazorGenerate (.cshtml) öğelerini oluşturulan Razor derlemeye eklenmiş dosyalar olarak ekler. varsayılan değeridir false.
GenerateMvcApplicationPartsAssemblyAttributes	.NET 6 ve sonraki sürümlerde kullanılmaz.
DefaultWebContentItemExcludes	Web veya Razor SDK'yı hedefleyen projelerde öğe grubundan Content dışlanacak öğe öğeleri için globing deseni
ExcludeConfigFilesFromBuildOutput	, .config ve .json dosyaları derleme çıktı dizinine kopyalanmıyorsatrue.
AddRazorSupportForMvc	olduğundatrue, SDK'yı MVC görünümleri veya Razor Sayfaları içeren uygulamalar oluştururken gereken MVC yapılandırması için destek ekleyecek şekilde yapılandırıyorRazor. Bu özellik, Web SDK'sını hedefleyen .NET Core 3.0 veya üzeri projeler için örtük olarak ayarlanır
RazorLangVersion	Hedef alınacak Dilin Razor sürümü.
EmitCompilerGeneratedFiles	olarak trueayarlandığında, oluşturulan kaynak dosyalar diske yazılır. true ayarı, derleyicide hata ayıklarken kullanışlıdır. Varsayılan değer: false.

Özellikler hakkında daha fazla bilgi için bkz . MSBuild özellikleri.

Görünümlerin çalışma zamanı derlemesi Razor

• Varsayılan olarak SDK, Razor çalışma zamanı derlemesi gerçekleştirmek için gereken başvuru derlemelerini yayımlamaz. Bu, uygulama modeli çalışma zamanı derlemesine bağlı olduğunda derleme hatalarıyla sonuçlanır; örneğin, uygulama yayımlandıktan sonra eklenmiş görünümler kullanır veya görünümleri değiştirir. Başvuru derlemelerini yayımlamaya devam etmek için true olarak ayarlayınCopyRefAssembliesToPublishDirectory. Hem kod oluşturma hem de derleme, derleyiciye yapılan tek bir çağrı tarafından desteklenir. Uygulama türlerini ve oluşturulan görünümleri içeren tek bir derleme oluşturulur.

• Bir web uygulaması için uygulamanızın SDK'yı hedeflediğinden Microsoft.NET.Sdk.Web emin olun.

Razor dil sürümü

SDK hedeflenirken Microsoft.NET.Sdk.Web , Razor dil sürümü uygulamanın hedef çerçeve sürümünden çıkarılır. SDK'yı hedefleyen Microsoft.NET.Sdk.Razor projeler için veya nadiren de olsa uygulamanın çıkarılmış değerden farklı Razor bir dil sürümüne ihtiyaç duyması durumunda, uygulamanın proje dosyasında özelliği ayarlanarak <RazorLangVersion> bir sürüm yapılandırılabilir:

<PropertyGroup>
  <RazorLangVersion>{VERSION}</RazorLangVersion>
</PropertyGroup>

Razor'nin dil sürümü, oluşturulduğu çalışma zamanının sürümüyle sıkı bir şekilde tümleştirilmiştir. Çalışma zamanı için tasarlanmamış bir dil sürümünü hedefleme desteklenmiyor ve büyük olasılıkla derleme hataları oluşturuyor.

Ek kaynaklar

• .NET Core için csproj biçimine eklemeler
• Ortak MSBuild proje öğeleri