ASP.NET Core Razor SDK

Autor: Rick Anderson

Přehled

Sada .NET 6.0 SDK obsahuje Microsoft.NET.Sdk.Razor sadu MSBuild SDK (Razor SDK). Sada Razor SDK:

• Vyžaduje se k sestavení, zabalení a publikování projektů obsahujících Razor soubory pro ASP.NET základní MVC nebo Blazor projekty.
• Obsahuje sadu předdefinovaných vlastností a položky, které umožňují přizpůsobení kompilace Razor (.cshtml nebo .razor) souborů.

Sada Razor SDK obsahuje Content položky s Include atributy nastavenými na **\*.cshtml**\*.razor vzory a vzory globbingu. Publikují se odpovídající soubory.

Požadavky

Sada .NET 6.0 SDK

Razor Použití sady SDK

Většina webových aplikací nemusí explicitně odkazovat na Razor sadu SDK.

Pokud chcete sadu SDK použít Razor k vytváření knihoven tříd obsahujících Razor zobrazení nebo Razor stránky, doporučujeme začít se šablonou Razor projektu knihovny tříd (RCL). Seznam RCL, který se používá k sestavení Blazor (.razor) souborů minimálně, vyžaduje odkaz na balíček Microsoft.AspNetCore.Components . Seznam RCL, který se používá k sestavení Razor zobrazení nebo stránek (.cshtmlsouborů) minimálně vyžaduje cílení netcoreapp3.0 nebo novější a má FrameworkReference v souboru projektu metapackage Microsoft.AspNetCore.App.

Vlastnosti

Chování sady SDK v rámci sestavení projektu řídí Razornásledující vlastnosti:

• RazorCompileOnBuild: Když true, kompiluje a generuje Razor sestavení jako součást sestavení projektu. Výchozí hodnota trueje .
• RazorCompileOnPublish: Když true, kompiluje a generuje Razor sestavení jako součást publikování projektu. Výchozí hodnota trueje .
• UseRazorSourceGenerator: Výchozí hodnota trueje . Kdy: true
  • Zkompiluje se pomocí generování zdroje.
  • Nevytvoří <app_name>.Views.dll. Zobrazení jsou součástí <app_name>.dll.
  • Podporuje rozhraní .NET Opětovné načítání za provozu.

Vlastnosti a položky v následující tabulce slouží ke konfiguraci vstupů a výstupu Razor do sady SDK.

Items	Popis
RazorGenerate	Prvky položky (.cshtml soubory), které jsou vstupy do generování kódu.
RazorComponent	Elementy položky (.razor soubory), které jsou vstupy do Razor generování kódu komponenty.
RazorCompile	Prvky položky (.cs soubory), které jsou vstupy cílů Razor kompilace. Pomocí tohoto ItemGroup příkazu můžete zadat další soubory, které se mají zkompilovat do Razor sestavení.
RazorEmbeddedResource	Prvky položky přidané jako vložené prostředky do vygenerovaného Razor sestavení.

Vlastnost	Popis
RazorOutputPath	Výstupní Razor adresář.
RazorCompileToolset	Slouží k určení sady nástrojů použité k sestavení Razor sestavení. Platné hodnoty jsou Implicit, RazorSDK a PrecompilationTool.
EnableDefaultContentItems	Výchozí hodnota je true. Pokud trueobsahuje web.config.json a .cshtml soubory jako obsah v projektu. Při odkazech prostřednictvím Microsoft.NET.Sdk.Websouborů wwwroot a konfiguračních souborů jsou zahrnuty také.
EnableDefaultRazorGenerateItems	Pokud trueobsahuje .cshtml soubory z Content položek v RazorGenerate položkách.
GenerateRazorTargetAssemblyInfo	Nepoužívá se v .NET 6 a novějším.
EnableDefaultRazorTargetAssemblyInfoAttributes	Nepoužívá se v .NET 6 a novějším.
CopyRazorGenerateFilesToPublishDirectory	Když truezkopíruje RazorGenerate položky (.cshtml) soubory do adresáře publikování. Soubory se obvykle nevyžadují pro publikovanou aplikaci, Razor pokud se účastní kompilace v době sestavení nebo v době publikování. Výchozí hodnota falseje .
PreserveCompilationReferences	Když truezkopírujte odkazy na položky sestavení do adresáře publikování. Referenční sestavení se obvykle nevyžadují pro publikovanou aplikaci, pokud Razor dojde k kompilaci v době sestavení nebo v době publikování. Nastavte, true jestli publikovaná aplikace vyžaduje kompilaci modulu runtime. Například nastavte hodnotu na true , pokud aplikace upravuje .cshtml soubory za běhu nebo používá vložená zobrazení. Výchozí hodnota falseje .
IncludeRazorContentInPack	Pokud truejsou všechny Razor položky obsahu (.cshtml soubory) označené pro zahrnutí do vygenerovaného balíčku NuGet. Výchozí hodnota falseje .
EmbedRazorGenerateSources	Když truepřidáte Razorpoložky Generate (.cshtml) jako vložené soubory do vygenerovaného Razor sestavení. Výchozí hodnota falseje .
GenerateMvcApplicationPartsAssemblyAttributes	Nepoužívá se v .NET 6 a novějším.
DefaultWebContentItemExcludes	Vzor globbingu pro prvky položek, které mají být vyloučeny ze Content skupiny položek v projektech, které cílí na web nebo Razor sadu SDK
ExcludeConfigFilesFromBuildOutput	Pokud truese soubory .config a .json soubory nezkopírují do výstupního adresáře sestavení.
AddRazorSupportForMvc	Když truenakonfiguruje Razor sadu SDK tak, aby přidala podporu pro konfiguraci MVC, která se vyžaduje při vytváření aplikací obsahujících zobrazení MVC nebo Razor stránky. Tato vlastnost je implicitně nastavená pro projekty .NET Core 3.0 nebo novější, které cílí na webovou sadu SDK.
RazorLangVersion	Verze jazyka, Razor na který chcete cílit.
EmitCompilerGeneratedFiles	Při nastavení se truevygenerované zdrojové soubory zapisují na disk. Nastavení, které true je užitečné při ladění kompilátoru. Výchozí hodnota je false.

Další informace o vlastnostech naleznete v tématu MSBuild vlastnosti.

Kompilace Razor zobrazení za běhu

• Sada SDK ve výchozím nastavení Razor nepublikuje referenční sestavení, která jsou potřebná k provedení kompilace modulu runtime. Výsledkem jsou selhání kompilace, když model aplikace spoléhá na kompilaci za běhu – například aplikace po publikování aplikace používá vložená zobrazení nebo mění zobrazení. Nastavte CopyRefAssembliesToPublishDirectory na true pokračování publikování referenčních sestavení. Generování kódu i kompilace je podporováno jediným voláním kompilátoru. Vytvoří se jedno sestavení, které obsahuje typy aplikací a vygenerovaná zobrazení.

• U webové aplikace se ujistěte, že vaše aplikace cílí na Microsoft.NET.Sdk.Web sadu SDK.

Razor jazyková verze

Při cílení na Microsoft.NET.Sdk.Web sadu SDK Razor se verze jazyka odvodí z verze cílové architektury aplikace. U projektů, které cílí na Microsoft.NET.Sdk.Razor sadu SDK nebo ve výjimečných případech, že aplikace vyžaduje jinou Razor jazykovou verzi než odvozená hodnota, je možné nakonfigurovat verzi nastavením <RazorLangVersion> vlastnosti v souboru projektu aplikace:

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

RazorJazyková verze je úzce integrovaná s verzí modulu runtime, pro kterou byla vytvořena. Cílení na jazykovou verzi, která není navržená pro modul runtime, není podporována a pravděpodobně způsobí chyby sestavení.

Další prostředky

• Přidání formátu csproj pro .NET Core
• Běžné položky projektu NÁSTROJE MSBuild