dotnet / dotnet/docs

List of properties that can be specified in <ProjectReference Properties=""> is undocumented

Open
#29,781 2 comments 1 reaction 1 assignee Claimed by @gewarren View on GitHub
Dominant language
No language data
Stars
4.8k
Forks
6.1k
Avg merge
15h 21m
Merged PRs (30d)
370

Description

**Issue description**

This came out of an SDK support case. The list of properties that can be set in ProjectReference is undocumented. This list is not the same as the list in https://docs.microsoft.com/en-us/dotnet/core/project-sdk/msbuild-props or that document is incomplete (can't tell which). The list is also not the same as the list of all properties referenced in Microsoft.NET.Sdk.targets as at least one property referenced in there can't be set by Properties=.

In my view of these, I expect these to correspond to command line arguments to `dotnet build`, `dotnet pack`, or `dotnet publish`.

At least the following properties are missing documentation or have incomplete documentation:

* RuntimeIdentifier: sets the runtime identifier to build the target project for and reference as. Accepts empty string or `$(RuntimeIdentifier)` ; not clear how this interacts with `` property group item (note plural)
* SelfContained: accepts true or false to set the value of self-contained.

The list is semicolon separated; the existing document is so bad I had to probe for that!

**Target framework**

- [X] .NET Core (only tried 6.0)
- [ ] .NET Framework
- [ ] .NET Standard

```console
c>dotnet --version
6.0.300
```

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.