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

[jhudsoncedaron]

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 <RuntimeIdentifiers> 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

• .NET Core (only tried 6.0)
• .NET Framework
• .NET Standard

Details

c>dotnet --version
6.0.300

[gewarren]

There's a document that describes some of the metadata you can add to ProjectReference here: https://docs.microsoft.com/en-us/visualstudio/msbuild/common-msbuild-project-items?view=vs-2022#projectreference. It sounds like the metadata you want to see added is particular to the .NET SDK though - is that correct?

FYI @ghogen.

[jhudsoncedaron]

@gewarren : You are correct I'm talking about properties specific to .NET SDK.