Conversation
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/fd388405-b14a-4f14-ab50-18f84128f21a Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Clarify that TargetFramework is an alias for TargetFrameworkMoniker
Clarify TargetFramework as TFM alias and document SDK 10.0.300 multi-TFM equivalence
Apr 6, 2026
gewarren
approved these changes
Apr 7, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the .NET SDK MSBuild property reference to clarify how TargetFramework/TargetFrameworks values are interpreted, including noting that the SDK parses TFMs into other derived MSBuild properties, and documenting a .NET SDK 10.0.300 multi-targeting equivalence behavior.
Changes:
- Added a note under
TargetFrameworkexplaining that the SDK parses the value and populates related MSBuild properties. - Added a note under
TargetFrameworksabout .NET SDK 10.0.300 allowing multiple entries that resolve to the same effective framework.
nkolev92
approved these changes
Apr 7, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The
TargetFramework/TargetFrameworksMSBuild property docs didn't explain that these values are aliases the SDK translates into canonical moniker properties, nor the SDK 10.0.300 behavior where multipleTargetFrameworksvalues can resolve to the same effective framework.Changes to
msbuild-props.mdTargetFramework: Adds a note that the value is an alias — the .NET SDK parses it and setsTargetFrameworkMoniker,TargetFrameworkIdentifier,TargetFrameworkVersion, and (when applicable)TargetPlatformIdentifier,TargetPlatformVersion, andTargetPlatformMoniker. Notes that users can set these properties directly when using a custom alias.TargetFrameworks: Adds a note that starting with .NET SDK 10.0.300, multiple values can resolve to the same effective framework — for example:Both
net10.0-linuxandnet10.0-macresolve tonet10.0.Internal previews