ASP.NET Core Razor SDK

Autor: Rick Anderson

Omówienie

Zestaw SDK platformy .NET 6.0 zawiera zestaw Microsoft.NET.Sdk.Razor MSBuild SDK (Razor SDK). Zestaw Razor SDK:

• Jest wymagane do kompilowania, tworzenia, tworzenia i publikowania projektów zawierających Razor pliki dla ASP.NET Core MVC lub Blazor projektów.
• Zawiera zestaw wstępnie zdefiniowanych właściwości i elementów, które umożliwiają dostosowywanie kompilacji Razor plików (.cshtml lub .razor).

Zestaw Razor SDK zawiera Content elementy z atrybutami ustawionymi Include na **\*.cshtml wzorce globbing i **\*.razor . Pliki pasujące są publikowane.

Wymagania wstępne

Zestaw SDK dla platformy .NET 6.0

Korzystanie z zestawu Razor SDK

Większość aplikacji internetowych nie jest wymagana do jawnego odwołowania się do zestawu Razor SDK.

Aby użyć Razor zestawu SDK do kompilowania bibliotek klas zawierających Razor widoki lub Razor strony, zalecamy rozpoczęcie od Razor szablonu projektu biblioteki klas (RCL). Lista RCL używana do kompilowania Blazor () plików (.razor) minimalnie wymaga odwołania do pakietu Microsoft.AspNetCore.Components . Lista RCL używana do kompilowania Razor widoków lub stron (.cshtml plików) minimalnie wymaga określania wartości docelowej netcoreapp3.0 lub nowszej i ma wartość FrameworkReferencedla Microsoft.AspNetCore.App metapakietu w pliku projektu.

Właściwości

Następujące właściwości kontrolują Razorzachowanie zestawu SDK w ramach kompilacji projektu:

• RazorCompileOnBuild: gdy trueprogram kompiluje i emituje Razor zestaw w ramach kompilowania projektu. Wartość domyślna to true.
• RazorCompileOnPublish: gdy trueprogram kompiluje i emituje Razor zestaw w ramach publikowania projektu. Wartość domyślna to true.
• UseRazorSourceGenerator: Wartość domyślna to true. Czas: true
  • Kompiluje się przy użyciu generowania źródła.
  • Nie tworzy elementu <app_name>.Views.dll. Widoki są uwzględniane w elem <app_name>.dll.
  • Obsługuje Przeładowywanie na gorąco .NET.

Właściwości i elementy w poniższej tabeli służą do konfigurowania danych wejściowych i wyjściowych zestawu Razor SDK.

Elementy	opis
RazorGenerate	Elementy elementu (.cshtml pliki), które są danymi wejściowymi do generowania kodu.
RazorComponent	Elementy elementu (.razor pliki), które są danymi wejściowymi do Razor generowania kodu składnika.
RazorCompile	Elementy elementu (.cs pliki), które są danymi wejściowymi do Razor celów kompilacji. Służy do ItemGroup określania dodatkowych plików, które mają zostać skompilowane w Razor zestawie.
RazorEmbeddedResource	Elementy elementu dodane jako zasoby osadzone do wygenerowanego Razor zestawu.

Właściwości	opis
RazorOutputPath	Razor Katalog wyjściowy.
RazorCompileToolset	Służy do określania zestawu narzędzi używanego do kompilowania Razor zestawu. Prawidłowe wartości to Implicit, RazorSDK i PrecompilationTool.
EnableDefaultContentItems	Wartość domyślna to true. Jeśli trueelement zawiera plik web.config, .jsoni .cshtml pliki jako zawartość w projekcie. W przypadku odwoływanie się za pośrednictwem programu Microsoft.NET.Sdk.Webpliki wwwroot i config są również uwzględniane.
EnableDefaultRazorGenerateItems	Gdy trueelement zawiera .cshtml pliki z Content elementów w RazorGenerate elementach.
GenerateRazorTargetAssemblyInfo	Nie jest używany w programie .NET 6 lub nowszym.
EnableDefaultRazorTargetAssemblyInfoAttributes	Nie jest używany w programie .NET 6 lub nowszym.
CopyRazorGenerateFilesToPublishDirectory	Gdy trueprogram kopiuje RazorGenerate pliki elementów (.cshtml) do katalogu publikowania. Zazwyczaj pliki nie są wymagane dla opublikowanej aplikacji, Razor jeśli uczestniczą w kompilacji w czasie kompilacji lub w czasie publikowania. Wartość domyślna to false.
PreserveCompilationReferences	W przypadku truepolecenia skopiuj odwołania do elementów zestawu do katalogu publikowania. Zazwyczaj zestawy referencyjne nie są wymagane dla opublikowanej aplikacji, jeśli Razor kompilacja występuje w czasie kompilacji lub w czasie publikowania. Ustaw wartość , true jeśli opublikowana aplikacja wymaga kompilacji środowiska uruchomieniowego. Na przykład ustaw wartość na true , jeśli aplikacja modyfikuje .cshtml pliki w czasie wykonywania lub używa osadzonych widoków. Wartość domyślna to false.
IncludeRazorContentInPack	Gdy truewszystkie Razor elementy zawartości (.cshtml pliki) są oznaczone do dołączeniu do wygenerowanego pakietu NuGet. Wartość domyślna to false.
EmbedRazorGenerateSources	Gdy truepolecenie dodaje Razorelementy Generate (.cshtml) jako pliki osadzone do wygenerowanego Razor zestawu. Wartość domyślna to false.
GenerateMvcApplicationPartsAssemblyAttributes	Nie jest używany w programie .NET 6 lub nowszym.
DefaultWebContentItemExcludes	Wzorzec globbingu dla elementów, które mają być wykluczone z Content grupy elementów w projektach przeznaczonych dla sieci Web lub Razor zestawu SDK
ExcludeConfigFilesFromBuildOutput	Gdy trueplik .config i .json pliki nie są kopiowane do katalogu wyjściowego kompilacji.
AddRazorSupportForMvc	Gdy trueprogram konfiguruje Razor zestaw SDK w celu dodania obsługi konfiguracji MVC wymaganej podczas kompilowania aplikacji zawierających widoki MVC lub Razor strony. Ta właściwość jest niejawnie ustawiana dla projektów platformy .NET Core 3.0 lub nowszych przeznaczonych dla zestawu Web SDK
RazorLangVersion	Wersja Razor języka na docelową.
EmitCompilerGeneratedFiles	Po ustawieniu wartości truena wartość generowane pliki źródłowe są zapisywane na dysku. Ustawienie na true wartość jest przydatne podczas debugowania kompilatora. Wartość domyślna to false.

Aby uzyskać więcej informacji na temat właściwości, zobacz Właściwości programu MSBuild.

Kompilacja widoków Razor w czasie wykonywania

• Domyślnie zestaw Razor SDK nie publikuje zestawów odwołań, które są wymagane do wykonania kompilacji środowiska uruchomieniowego. Powoduje to błędy kompilacji, gdy model aplikacji opiera się na kompilacji środowiska uruchomieniowego — na przykład aplikacja używa osadzonych widoków lub zmienia widoki po opublikowaniu aplikacji. Ustaw CopyRefAssembliesToPublishDirectory wartość , aby true kontynuować publikowanie zestawów odwołań. Zarówno generowanie kodu, jak i kompilacja są obsługiwane przez pojedyncze wywołanie kompilatora. Tworzony jest pojedynczy zestaw zawierający typy aplikacji i wygenerowane widoki.

• W przypadku aplikacji internetowej upewnij się, że aplikacja jest przeznaczona dla zestawu Microsoft.NET.Sdk.Web SDK.

Razor wersja języka

W przypadku określania wartości docelowej Microsoft.NET.Sdk.Web zestawu SDK Razor wersja języka jest wnioskowana z docelowej wersji platformy aplikacji. W przypadku projektów przeznaczonych dla Microsoft.NET.Sdk.Razor zestawu SDK lub w rzadkich przypadkach aplikacja wymaga innej Razor wersji językowej niż wywnioskowana wartość, można skonfigurować wersję, ustawiając <RazorLangVersion> właściwość w pliku projektu aplikacji:

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

RazorWersja języka jest ściśle zintegrowana z wersją środowiska uruchomieniowego, dla którego została utworzona. Określanie wersji językowej, która nie jest przeznaczona dla środowiska uruchomieniowego, jest nieobsługiwana i prawdopodobnie generuje błędy kompilacji.

Dodatkowe zasoby

• Dodatki do formatu csproj dla platformy .NET Core
• Typowe elementy projektu MSBuild