Documentation incorrectly refers to DefaultItemExcludesInProjectFolder as DefaultExcludesInProjectFolder

[binki]

The documentation states that DefaultExcludesInProjectFolder is a property I can set in my project files to append project-folder-specific item excludes. However, the actual property name is DefaultItemExcludesInProjectFolder.

In Microsoft.NET.Sdk.DefaultItems.targets, you can see how, while DefaultExcludesInProjectFolder is used for the internal implementation of DefaultItemExcludesInProjectFolder, it is completely ignored. The SDK only consumes the user-defined DefaultItemExcludesInProjectFolder instead.

This was later changed in dotnet/sdk@3b684c6 which causes sdk versions 7+ to also consume DefaultExcludesInProjectFolder. However, the latest stable release, 6.0.302, requires the user to specify DefaultItemExcludesInProjectFolder. I spent hours trying to figure out why the buildsystem was not complying with my request even though I was faithfully following the documentation carefully. I eventually traced through the framework code and arrived at Microsoft.NET.Sdk.DefaultItems.targets.

Please update the documentation to clearly state that DefaultItemExcludesInProjectFolder is the correct property name. Please also document the information in dotnet/sdk#24063 about how DefaultExcludesInProjectFolder only works in sdk 7+ and that, to support all versions, the only option is to use DefaultItemExcludesInProjectFolder instead.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: cb4428fc-215c-78e1-5ff0-fe73f7a08260
• Version Independent ID: 6741b1de-38a4-fbb1-d79d-acc47d549a2d
• Content: MSBuild properties for Microsoft.NET.Sdk - .NET
• Content Source: docs/core/project-sdk/msbuild-props.md
• Product: dotnet-fundamentals
• GitHub Login: @gewarren
• Microsoft Alias: gewarren