Razor zestaw SDK ASP.NET Core

Rick Anderson

Overview

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

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

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

Prerequisites

SDK .NET 6

Użyj zestawu SDK Razor

Większość aplikacji internetowych nie wymaga jawnego odwoływania się do pakietu SDK Razor.

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). Biblioteka RCL używana do kompilowania plików Blazor (.razor) wymaga co najmniej odwołania do pakietu Microsoft.AspNetCore.Components. Biblioteka RCL używana do kompilowania Razor widoków lub stron (.cshtml plików) minimalnie wymaga określenia wartości docelowej netcoreapp3.0 lub nowszej i ma odwołanie FrameworkReference do metapakietu Microsoft.AspNetCore.App w pliku projektu.

Properties

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

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

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

Items Description
RazorGenerate Elementy elementów (pliki .cshtml), które są danymi wejściowymi do generowania kodu.
RazorComponent Elementy elementów (.razor pliki), które są danymi wejściowymi na potrzeby generowania kodu składnika Razor.
RazorCompile Elementy elementów (.cs pliki), które są danymi wejściowymi do Razor obiektów docelowych kompilacji. Za pomocą elementu ItemGroup można określić dodatkowe pliki, które mają zostać skompilowane do zestawu Razor.
RazorEmbeddedResource Elementy dodane jako zasoby osadzone do wygenerowanej Razor asemblacji.
Property Description
RazorOutputPath Razor Katalog wyjściowy.
RazorCompileToolset Służy do określania zestawu narzędzi używanego do kompilowania asemblacji Razor. Prawidłowe wartości to Implicit, RazorSDK i PrecompilationTool.
EnableDefaultContentItems Wartość domyślna to true. Gdy true, uwzględnia pliki web.config, .json i .cshtml jako zawartość projektu. W przypadku odwoływania się za pośrednictwem Microsoft.NET.Sdk.Web, pliki w folderze wwwroot i pliki config są również uwzględniane.
EnableDefaultRazorGenerateItems Gdy true, uwzględnia pliki .cshtml z elementów Content w elementach RazorGenerate.
GenerateRazorTargetAssemblyInfo Nie jest używany w programie .NET 6 lub nowszym.
EnableDefaultRazorTargetAssemblyInfoAttributes Nie jest używany w programie .NET 6 lub nowszym.
CopyRazorGenerateFilesToPublishDirectory Gdy true program kopiuje pliki RazorGenerate elementów (.cshtml) do katalogu publikowania. Zazwyczaj Razor pliki nie są wymagane dla opublikowanej aplikacji, jeśli uczestniczą w kompilacji w czasie kompilacji lub w czasie publikowania. Wartość domyślna to false.
PreserveCompilationReferences Gdy true, skopiuj elementy zestawu referencyjnego do katalogu publikacji. Zazwyczaj zestawy referencyjne nie są wymagane dla opublikowanej aplikacji, jeśli kompilacja Razor odbywa się w czasie kompilacji lub w czasie publikacji. Ustaw na true, jeśli opublikowana aplikacja wymaga kompilacji w czasie wykonywania. 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 ustawiono true, wszystkie Razor elementy zawartości (.cshtml pliki) są oznaczone do dołączenia do wygenerowanego pakietu NuGet. Wartość domyślna to false.
EmbedRazorGenerateSources Gdy true dodaje elementy RazorGenerate (.cshtml) jako pliki osadzone do wygenerowanego zestawu Razor. 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 pliki true, .config i .json nie są kopiowane do katalogu wyjściowego kompilacji.
AddRazorSupportForMvc Gdy true konfiguruje zestaw SDK Razor, aby dodać obsługę konfiguracji MVC wymaganą podczas kompilowania aplikacji zawierających widoki MVC lub strony Razor. Ta właściwość jest niejawnie ustawiana dla projektów platformy .NET Core 3.0 lub nowszych ukierunkowanych na zestaw Web SDK
RazorLangVersion Wersja języka Razor docelowego.
EmitCompilerGeneratedFiles Po ustawieniu wartości true generowane pliki źródłowe są zapisywane na dysku. Ustawienie wartości true 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 w czasie wykonywania. Powoduje to błędy kompilacji, gdy model aplikacji opiera się na kompilacji w czasie wykonywania — na przykład aplikacja używa osadzonych widoków lub zmienia widoki po opublikowaniu aplikacji. Ustaw wartość CopyRefAssembliesToPublishDirectory na true, aby kontynuować publikowanie zestawów odwołań. Zarówno generowanie kodu, jak i kompilacja są obsługiwane przez pojedyncze wywołanie kompilatora. Tworzona jest pojedyncza aseblacja zawierająca typy aplikacji i wygenerowane widoki.

  • W przypadku aplikacji internetowej upewnij się, że aplikacja korzysta z pakietu SDK Microsoft.NET.Sdk.Web.

Razor wersja językowa

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

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

Wersja językowa elementu Razor 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, nie jest obsługiwane i prawdopodobnie generuje błędy kompilacji.

Dodatkowe zasoby

.NET Core 2.1 lub nowszy SDK zawiera Microsoft.NET.Sdk.Razor MSBuild SDK (Razor SDK). Zestaw Razor SDK:

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

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

Prerequisites

.NET Core 2.1 lub nowszy zestaw SDK

Użyj zestawu SDK Razor

Większość aplikacji internetowych nie musi jawnie odwoływać się do zestawu SDK Razor.

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). Biblioteka RCL używana do kompilowania plików Blazor (.razor) wymaga co najmniej odwołania do pakietu Microsoft.AspNetCore.Components. Biblioteka RCL używana do tworzenia Razor widoków lub stron (.cshtml plików) minimalnie wymaga określania wartości docelowej netcoreapp3.0 lub nowszej i ma odwołanie FrameworkReference do Microsoft.AspNetCore.App metapakietu w pliku projektu.

Properties

Następujące właściwości kontrolują zachowanie SDK elementu Razor w ramach kompilacji projektu:

  • RazorCompileOnBuild: gdy true, kompiluje i emituje Razor asemblację w ramach kompilowania projektu. Wartość domyślna to true.
  • RazorCompileOnPublish: gdy true, kompiluje i emituje asemblację Razor w ramach publikowania projektu. Wartość domyślna to true.

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

Warning

Począwszy od ASP.NET Core 3.0 widoki MVC lub strony Razor nie są domyślnie udostępniane, jeśli właściwości MSBuild RazorCompileOnBuild lub RazorCompileOnPublish w pliku projektu są wyłączone. Aplikacje muszą dodać jawne odwołanie do pakietu Microsoft.AspNetCore.Mvc.RazorRuntimeCompilation, jeśli aplikacja korzysta z kompilacji środowiska uruchomieniowego do przetwarzania .cshtml plików.

Items Description
RazorGenerate Elementy pozycji (.cshtml pliki), które są danymi wejściowymi do generowania kodu.
RazorComponent Elementy elementów (.razor pliki), które są danymi wejściowymi do generowania kodu składnika przez Razor.
RazorCompile Elementy elementów (.cs pliki), które są danymi wejściowymi do celów kompilacji Razor. Użyj elementu ItemGroup, aby określić dodatkowe pliki, które mają zostać skompilowane do zestawu Razor.
RazorTargetAssemblyAttribute Elementy elementu Item używane do generowania atrybutów dla kompilacji Razor. Przykład:
RazorAssemblyAttribute
Include="System.Reflection.AssemblyMetadataAttribute"
_Parameter1="BuildSource" _Parameter2="https://learn.microsoft.com/">
RazorEmbeddedResource Elementy dodane jako zasoby osadzone do wygenerowanej Razor asemblacji.
Property Description
RazorTargetName Nazwa pliku (bez rozszerzenia) złożenia wygenerowanego przez Razor.
RazorOutputPath Razor Katalog wyjściowy.
RazorCompileToolset Służy do określania zestawu narzędzi używanego do kompilowania asemblacji Razor. Prawidłowe wartości to Implicit, RazorSDK i PrecompilationTool.
EnableDefaultContentItems Wartość domyślna to true. Gdy true, zawiera plik web.config, .json i .cshtml pliki jako zawartość w projekcie. Gdy odwołanie następuje za pośrednictwem Microsoft.NET.Sdk.Web, pliki w folderze wwwroot i pliki konfiguracyjne są również uwzględniane.
EnableDefaultRazorGenerateItems Gdy element true zawiera pliki .cshtml z elementów Content w elementach RazorGenerate.
GenerateRazorTargetAssemblyInfo Gdy true, generowany jest plik .cs zawierający atrybuty określone przez RazorAssemblyAttribute i dołączany do danych wyjściowych kompilacji.
EnableDefaultRazorTargetAssemblyInfoAttributes Gdy true, do RazorAssemblyAttribute dodawany jest domyślny zestaw atrybutów zestawu.
CopyRazorGenerateFilesToPublishDirectory Gdy true kopiuje RazorGenerate pliki elementów (.cshtml) do katalogu publikowania. Zazwyczaj Razor pliki nie są wymagane dla opublikowanej aplikacji, jeśli uczestniczą w kompilacji w czasie kompilacji lub w czasie publikowania. Wartość domyślna to false.
PreserveCompilationReferences Gdy true, skopiuj odwołania do elementów zestawu do katalogu publikowania. Zazwyczaj zestawy referencyjne nie są wymagane dla opublikowanej aplikacji, jeśli kompilacja Razor odbywa się w czasie kompilacji lub w czasie publikowania. Ustaw wartość true, jeśli opublikowana aplikacja wymaga kompilacji w czasie wykonywania. 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 ustawiono true, wszystkie Razor elementy zawartości (.cshtml pliki) są oznaczone do dołączenia do wygenerowanego pakietu NuGet. Wartość domyślna to false.
EmbedRazorGenerateSources Gdy true, dodaje elementy RazorGenerate (.cshtml) jako pliki osadzone do wygenerowanego zestawu Razor. Wartość domyślna to false.
UseRazorBuildServer Gdy true, używa trwałego procesu serwera kompilacji do odciążenia pracy związanej z generowaniem kodu. Wartość domyślna to UseSharedCompilation.
GenerateMvcApplicationPartsAssemblyAttributes Gdy true, zestaw SDK generuje dodatkowe atrybuty używane przez MVC w czasie wykonywania do odnajdywania części aplikacji.
DefaultWebContentItemExcludes Wzorzec globbingu dla elementów, które mają być wykluczone z Content grupy elementów w projektach ukierunkowanych na sieć Web lub zestaw SDK Razor
ExcludeConfigFilesFromBuildOutput Gdy true, .config i .json pliki nie są kopiowane do katalogu wyjściowego kompilacji.
AddRazorSupportForMvc Gdy true konfiguruje zestaw SDK Razor w celu dodania obsługi konfiguracji MVC wymaganej podczas kompilowania aplikacji zawierających widoki MVC lub strony Razor. Ta właściwość jest niejawnie ustawiana dla projektów platformy .NET Core 3.0 lub nowszych ukierunkowanych na zestaw Web SDK
RazorLangVersion Wersja docelowego języka Razor.

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

Targets

Zestaw Razor SDK definiuje dwie główne platformy docelowe:

  • RazorGenerate: Kod generuje .cs pliki z elementów item RazorGenerate. Użyj właściwości RazorGenerateDependsOn, aby określić dodatkowe elementy docelowe, które mogą być uruchamiane przed lub po tym elemencie docelowym.
  • RazorCompile: kompiluje wygenerowane pliki .cs do złożenia Razor. Użyj elementu RazorCompileDependsOn, aby określić dodatkowe elementy docelowe, które mogą być uruchamiane przed lub po tym elemencie docelowym.
  • RazorComponentGenerate: Kod generuje .cs pliki dla RazorComponent elementów Item. Użyj właściwości RazorComponentGenerateDependsOn, aby określić dodatkowe elementy docelowe, które mogą być uruchamiane przed lub po tym elemencie docelowym.

Kompilacja widoków Razor w czasie wykonywania

  • Domyślnie zestaw SDK Razor nie publikuje zestawów odwołań, które są wymagane do wykonania kompilacji w czasie wykonywania. Powoduje to błędy kompilacji, gdy model aplikacji opiera się na kompilacji w czasie wykonywania — na przykład aplikacja używa osadzonych widoków lub zmienia widoki po opublikowaniu aplikacji. Ustaw CopyRefAssembliesToPublishDirectory na true, aby kontynuować publikowanie zestawów referencyjnych.

  • W przypadku aplikacji internetowej upewnij się, że aplikacja jest ukierunkowana na pakiet SDK Microsoft.NET.Sdk.Web.

Razor wersja językowa

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

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

Wersja językowa elementu Razor 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, nie jest obsługiwane i prawdopodobnie generuje błędy kompilacji.

Dodatkowe zasoby

  • Standaryzuje sposób tworzenia, pakowania i publikowania projektów zawierających pliki Razor dla projektów opartych na ASP.NET Core MVC.
  • Zawiera zestaw wstępnie zdefiniowanych obiektów docelowych, właściwości i elementów, które umożliwiają dostosowywanie kompilacji plików Razor.

Zestaw SDK Razor zawiera element Content z atrybutem Include ustawionym na wzorzec globbingu **\*.cshtml. Pliki pasujące są publikowane.

Prerequisites

.NET Core 2.1 lub nowszy zestaw SDK

Użyj zestawu SDK Razor

Większość aplikacji internetowych nie musi jawnie odwoływać się do zestawu SDK Razor.

Aby użyć zestawu Razor SDK do kompilowania bibliotek klas zawierających Razor widoki lub Razor strony:

  • Użyj Microsoft.NET.Sdk.Razor zamiast Microsoft.NET.Sdk:

    <Project SDK="Microsoft.NET.Sdk.Razor">
      <!-- omitted for brevity -->
    </Project>
    
  • Zazwyczaj wymagane jest odwołanie do pakietu Microsoft.AspNetCore.Mvc, aby otrzymać dodatkowe zależności wymagane do tworzenia i kompilowania stron Razor i widoków Razor Co najmniej Twój projekt powinien dodać odwołania do pakietów:

    • Microsoft.AspNetCore.Razor.Design
    • Microsoft.AspNetCore.Mvc.Razor.Extensions
    • Microsoft.AspNetCore.Mvc.Razor

    Pakiet Microsoft.AspNetCore.Razor.Design udostępnia zadania kompilacji Razor i cele dla projektu.

    Poprzednie pakiety są uwzględnione w Microsoft.AspNetCore.Mvc. Poniższy znacznik przedstawia plik projektu, który używa Razor zestawu SDK do kompilowania Razor plików dla aplikacji ASP.NET Core Razor Pages:

    <Project Sdk="Microsoft.NET.Sdk.Razor">
    
      <PropertyGroup>
        <TargetFramework>netcoreapp2.1</TargetFramework>
      </PropertyGroup>
    
      <ItemGroup>
        <PackageReference Include="Microsoft.AspNetCore.Mvc" Version="2.1.3" />
      </ItemGroup>
    
    </Project>
    

Warning

Pakiety Microsoft.AspNetCore.Razor.Design i Microsoft.AspNetCore.Mvc.Razor.Extensions znajdują się w Microsoft.AspNetCore.App metapakiecie. Jednak odwołanie do pakietu Microsoft.AspNetCore.App bez określenia wersji udostępnia aplikacji metapakiet, który nie zawiera najnowszej wersji Microsoft.AspNetCore.Razor.Design. Projekty muszą odwoływać się do spójnej wersji Microsoft.AspNetCore.Razor.Design (lub Microsoft.AspNetCore.Mvc), aby uwzględnić najnowsze poprawki w czasie kompilacji dotyczące Razor. Aby uzyskać więcej informacji, zobacz ten problem w serwisie GitHub.

Properties

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

  • RazorCompileOnBuild: gdy true, program kompiluje i emituje Razor asemb­lację w ramach kompilowania projektu. Wartość domyślna to true.
  • RazorCompileOnPublish: Gdy true, program kompiluje i emituje Razor zestawienie w ramach publikowania projektu. Wartość domyślna to true.

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

Items Description
RazorGenerate Elementy elementu item (.cshtml pliki), które są danymi wejściowymi do generowania kodu.
RazorComponent Elementy elementu/itemu (.razor pliki), które są danymi wejściowymi używanymi do generowania kodu składnika Razor.
RazorCompile Elementy Item (.cs pliki), które są danymi wejściowymi dla Razor celów kompilacji. Użyj tego ItemGroup, aby określić dodatkowe pliki, które mają zostać skompilowane do złożenia Razor.
RazorTargetAssemblyAttribute Elementy elementu Item używane do generowania w kodzie atrybutów dla Razor asemblacji. Przykład:
RazorAssemblyAttribute
Include="System.Reflection.AssemblyMetadataAttribute"
_Parameter1="BuildSource" _Parameter2="https://learn.microsoft.com/">
RazorEmbeddedResource Elementy dodane jako zasoby osadzone do wygenerowanej Razor asemblacji.
Property Description
RazorTargetName Nazwa pliku (bez rozszerzenia) asemblacji wygenerowanej przez Razor.
RazorOutputPath Razor Katalog wyjściowy.
RazorCompileToolset Służy do określania zestawu narzędzi używanego do kompilowania asemblażu Razor. Prawidłowe wartości to Implicit, RazorSDK i PrecompilationTool.
EnableDefaultContentItems Wartość domyślna to true. Gdy true, uwzględnia pliki web.config, .json i .cshtml jako zawartość w projekcie. Gdy odwołuje się do nich za pomocą Microsoft.NET.Sdk.Web, pliki w folderze wwwroot i pliki konfiguracji są również uwzględniane.
EnableDefaultRazorGenerateItems Gdy element true zawiera .cshtml pliki z elementów Content w elementach RazorGenerate.
GenerateRazorTargetAssemblyInfo Gdy true, program generuje plik .cs zawierający atrybuty określone przez RazorAssemblyAttribute i dołącza ten plik do danych wyjściowych kompilacji.
EnableDefaultRazorTargetAssemblyInfoAttributes Gdy używane jest true, do RazorAssemblyAttribute dodawany jest domyślny zestaw atrybutów zestawu.
CopyRazorGenerateFilesToPublishDirectory Gdy true, kopiuje RazorGenerate pliki elementu (.cshtml) do katalogu publikowania. Zazwyczaj pliki Razor nie są wymagane w opublikowanej aplikacji, jeśli uczestniczą w kompilacji na etapie kompilowania lub publikowania. Wartość domyślna to false.
CopyRefAssembliesToPublishDirectory Gdy true, skopiuj elementy zestawu referencyjnego do katalogu publikowania. Zazwyczaj zestawy referencyjne nie są wymagane dla opublikowanej aplikacji, jeśli Razor kompilacja odbywa się w czasie kompilacji lub w czasie publikowania. Ustaw na true, jeśli opublikowana aplikacja wymaga kompilacji w czasie wykonywania. 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 ustawiono true, wszystkie Razor elementy zawartości (.cshtml pliki) są oznaczone do dołączenia do wygenerowanego pakietu NuGet. Wartość domyślna to false.
EmbedRazorGenerateSources Gdy true, dodaje elementy RazorGenerate (.cshtml) jako pliki osadzone do wygenerowanego zestawu Razor. Wartość domyślna to false.
UseRazorBuildServer Gdy true, używa trwałego procesu serwera kompilacji do odciążenia procesu generowania kodu. Wartość domyślna to UseSharedCompilation.
GenerateMvcApplicationPartsAssemblyAttributes Gdy true, zestaw SDK generuje dodatkowe atrybuty używane przez MVC w czasie wykonywania do odnajdywania części aplikacji.
DefaultWebContentItemExcludes Wzorzec globbingu dla elementów, które mają być wykluczone z grupy elementów Content w projektach ukierunkowanych na sieć Web lub zestaw SDK Razor
ExcludeConfigFilesFromBuildOutput Gdy pliki true.config i .json nie są kopiowane do katalogu wyjściowego kompilacji.
AddRazorSupportForMvc Gdy true konfiguruje zestaw SDK Razor, aby dodać obsługę konfiguracji MVC wymaganej podczas kompilowania aplikacji zawierających widoki MVC lub strony Razor. Ta właściwość jest niejawnie ustawiana dla projektów platformy .NET Core 3.0 lub nowszych ukierunkowanych na zestaw Web SDK
RazorLangVersion Wersja Razor języka docelowego.

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

Targets

Zestaw Razor SDK definiuje dwie główne platformy docelowe:

  • RazorGenerate: Kod generuje .cs pliki z elementów RazorGenerate. Użyj właściwości RazorGenerateDependsOn, aby określić dodatkowe elementy docelowe, które mogą być uruchamiane przed lub po tym elemencie docelowym.
  • RazorCompile: kompiluje wygenerowane pliki .cs do złożenia Razor. Użyj RazorCompileDependsOn, aby określić dodatkowe cele, które mogą być uruchamiane przed lub po tym celu.
  • RazorComponentGenerate: Kod generuje .cs pliki dla RazorComponent elementów elementu Item. Użyj właściwości RazorComponentGenerateDependsOn, aby określić dodatkowe elementy docelowe, które mogą być uruchamiane przed lub po tym elemencie docelowym.

Kompilacja widoków Razor w czasie wykonywania

  • Domyślnie zestaw SDK Razor nie publikuje zestawów odwołań, które są wymagane do wykonania kompilacji w czasie wykonywania. Powoduje to błędy kompilacji, gdy model aplikacji opiera się na kompilacji w czasie wykonywania — na przykład aplikacja używa osadzonych widoków lub zmienia widoki po opublikowaniu aplikacji. Ustaw CopyRefAssembliesToPublishDirectory na true, aby kontynuować publikowanie zestawów referencyjnych.

  • W przypadku aplikacji internetowej upewnij się, że aplikacja jest ukierunkowana na zestaw SDK Microsoft.NET.Sdk.Web.

Razor wersja językowa

W przypadku korzystania z zestawu SDK Microsoft.NET.Sdk.Web wersja języka Razor jest wnioskowana z docelowej wersji platformy aplikacji. W przypadku projektów przeznaczonych dla Microsoft.NET.Sdk.Razor zestawu SDK lub w rzadkich przypadkach, gdy 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>

Razor wersja językowa 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, nie jest obsługiwane i prawdopodobnie generuje błędy kompilacji.

Dodatkowe zasoby