Fill in SDK gaps (#16690)

* Fill in SDK gaps

* Apply suggestions from code review

Co-Authored-By: Rick Anderson <3605364+Rick-Anderson@users.noreply.github.com>

* Update web-sdk.md (#16703)

* Update web-sdk.md

* Update web-sdk.md

Co-authored-by: Rick Anderson <3605364+Rick-Anderson@users.noreply.github.com>
pull/16707/head
Pranav K 2020-01-24 19:16:40 -08:00 committed by Rick Anderson
parent e2b2df189f
commit 45035fcab2
4 changed files with 68 additions and 20 deletions

View File

@ -121,6 +121,10 @@ The properties and items in the following table are used to configure inputs and
| `EmbedRazorGenerateSources` | When `true`, adds RazorGenerate (*.cshtml*) items as embedded files to the generated Razor assembly. Defaults to `false`. |
| `UseRazorBuildServer` | When `true`, uses a persistent build server process to offload code generation work. Defaults to the value of `UseSharedCompilation`. |
| `GenerateMvcApplicationPartsAssemblyAttributes` | When `true`, the SDK generates additional attributes used by MVC at runtime to perform application part discovery. |
| `DefaultWebContentItemExcludes` | A globbing pattern for item elements that are to be excluded from the `Content` item group in projects targeting the Web or Razor SDK |
| `ExcludeConfigFilesFromBuildOutput` | When `true`, *.config* and *.json* files do not get copied to the build output directory. |
| `AddRazorSupportForMvc` | When `true`, configures the Razor SDK to add support for the MVC configuration that is required when building applications containing MVC views or Razor Pages. This property is implicitly set for .NET Core 3.0 or later projects targeting the Web SDK |
| `RazorLangVersion` | The version of the Razor Language to target. |
For more information on properties, see [MSBuild properties](/visualstudio/msbuild/msbuild-properties).

View File

@ -0,0 +1,42 @@
---
title: ASP.NET Core Web SDK
author: Rick-Anderson
description: Overview of Microsoft.NET.Sdk.Web.
ms.author: riande
ms.date: 2/27/2020
no-loc: [Blazor]
uid: razor-pages/web-sdk
---
# ASP.NET Core Web SDK
### Overview
`Microsoft.NET.Sdk.Web` is a [MSBuild project SDK](https://docs.microsoft.com/visualstudio/msbuild/how-to-use-project-sdk) for building ASP.NET Core apps. It's possible to build an ASP.NET Core app without this SDK, however, the Web SDK is:
* Tailored towards providing a first-class experience.
* The recommended target for most users.
Use the Web.SDK in a project:
```xml
<Project SDK="Microsoft.NET.Sdk.Web">
<!-- omitted for brevity -->
</Project>
```
Features enabled by using the Web SDK:
* Projects targeting .NET Core 3.0 or later implicitly reference:
* The [ASP.NET Core shared framework](xref:fundamentals/metapackage-app).
* [Analyzers](xref:https://docs.microsoft.com/visualstudio/extensibility/getting-started-with-roslyn-analyzers) designed for building ASP.NET Core apps.
* The WebSDK enables MSBuild targets that enables the use of publish profiles, and publishing using WebDeploy.
### Properties
| Property | Description |
| -------- | ----------- |
| `DisableImplicitFrameworkReferences` | Disables implicit reference to the `Microsoft.AspNetCore.App` shared framework. |
| `DisableImplicitAspNetCoreAnalyzers` | Disables implicit reference to ASP.NET Core analyzers. |
| `DisableImplicitComponentsAnalyzers` | Disables implicit reference to Razor Components analyzers when building Blazor (server) applications. |

View File

@ -230,8 +230,6 @@
uid: razor-pages/filter
- name: Route and app conventions
uid: razor-pages/razor-pages-conventions
- name: Razor SDK
uid: razor-pages/sdk
- name: MVC
items:
- name: Overview
@ -409,21 +407,25 @@
href: mvc/views/working-with-forms.md#the-validation-summary-tag-helper
- name: Advanced
items:
- name: Application parts
uid: mvc/extensibility/app-parts
- name: Application model
uid: mvc/controllers/application-model
- name: Areas
uid: mvc/controllers/areas
- name: Filters
uid: mvc/controllers/filters
- name: Razor SDK
uid: razor-pages/sdk
- name: View components
uid: mvc/views/view-components
- name: View compilation
uid: mvc/views/view-compilation
- name: App model
uid: mvc/controllers/application-model
- name: Filters
uid: mvc/controllers/filters
- name: Areas
uid: mvc/controllers/areas
- name: Upload files
uid: mvc/models/file-uploads
- name: App parts
uid: mvc/extensibility/app-parts
- name: aspnet-codegenerator
- name: Web SDK
uid: razor-pages/web-sdk
- name: aspnet-codegenerator (Scaffolding)
uid: fundamentals/tools/dotnet-aspnet-codegenerator
- name: Web API apps
items: