Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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 (
.cshtmllub.razor).
Zestaw Razor SDK zawiera Content elementy z atrybutami Include ustawionymi na wzorce globbing **\*.cshtml i **\*.razor. Pliki pasujące są publikowane.
Prerequisites
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: gdytrue, program kompiluje i emituje asemblację Razor w ramach kompilowania projektu. Wartość domyślna totrue. -
RazorCompileOnPublish: Gdytrue, program kompiluje i emituje Razor asemblację w ramach publikowania projektu. Wartość domyślna totrue. -
UseRazorSourceGenerator: Wartość domyślna totrue. Kiedytrue:- 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ść
CopyRefAssembliesToPublishDirectorynatrue, 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
.cshtmllub.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: gdytrue, kompiluje i emituje Razor asemblację w ramach kompilowania projektu. Wartość domyślna totrue. -
RazorCompileOnPublish: gdytrue, kompiluje i emituje asemblację Razor w ramach publikowania projektu. Wartość domyślna totrue.
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: RazorAssemblyAttributeInclude="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.cspliki z elementów itemRazorGenerate. Użyj właściwościRazorGenerateDependsOn, aby określić dodatkowe elementy docelowe, które mogą być uruchamiane przed lub po tym elemencie docelowym. -
RazorCompile: kompiluje wygenerowane pliki.csdo złożenia Razor. Użyj elementuRazorCompileDependsOn, aby określić dodatkowe elementy docelowe, które mogą być uruchamiane przed lub po tym elemencie docelowym. -
RazorComponentGenerate: Kod generuje.cspliki dlaRazorComponentelementów Item. Użyj właściwościRazorComponentGenerateDependsOn, 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
CopyRefAssembliesToPublishDirectorynatrue, 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.RazorzamiastMicrosoft.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.DesignMicrosoft.AspNetCore.Mvc.Razor.ExtensionsMicrosoft.AspNetCore.Mvc.Razor
Pakiet
Microsoft.AspNetCore.Razor.Designudostę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: gdytrue, program kompiluje i emituje Razor asemblację w ramach kompilowania projektu. Wartość domyślna totrue. -
RazorCompileOnPublish: Gdytrue, program kompiluje i emituje Razor zestawienie w ramach publikowania projektu. Wartość domyślna totrue.
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: RazorAssemblyAttributeInclude="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.cspliki z elementówRazorGenerate. Użyj właściwościRazorGenerateDependsOn, aby określić dodatkowe elementy docelowe, które mogą być uruchamiane przed lub po tym elemencie docelowym. -
RazorCompile: kompiluje wygenerowane pliki.csdo złożenia Razor. UżyjRazorCompileDependsOn, aby określić dodatkowe cele, które mogą być uruchamiane przed lub po tym celu. -
RazorComponentGenerate: Kod generuje.cspliki dlaRazorComponentelementów elementu Item. Użyj właściwościRazorComponentGenerateDependsOn, 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
CopyRefAssembliesToPublishDirectorynatrue, 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.