Documentation: clarify ResolveAssemblyReference locations for .NET SDK

[hickford]

https://learn.microsoft.com/en-us/visualstudio/msbuild/troubleshoot-assembly-references?view=visualstudio#assemblysearchpaths
https://github.com/MicrosoftDocs/visualstudio-docs/blob/main/docs/msbuild/troubleshoot-assembly-references.md#assemblysearchpaths

By default, there are ten locations ResolveAssemblyReference searches (four if you use the .NET SDK), and each can be disabled by setting the relevant flag to false:

• Searching files from the current project is disabled by setting the AssemblySearchPath_UseCandidateAssemblyFiles property to false.
• Searching the reference path property (from a .user file) is disabled by setting the AssemblySearchPath_UseReferencePath property to false.
• Using the hint path from the item is disabled by setting the AssemblySearchPath_UseHintPathFromItem property to false.
• Using the directory with MSBuild's target runtime is disabled by setting the AssemblySearchPath_UseTargetFrameworkDirectory property to false.
• Searching assembly folders from AssemblyFolders.config is disabled by setting the AssemblySearchPath_UseAssemblyFoldersConfigFileSearchPath property to false.
• Searching the registry is disabled by setting the AssemblySearchPath_UseRegistry property to false.
• Searching legacy registered assembly folders is disabled by setting the AssemblySearchPath_UseAssemblyFolders property to false.
• Looking in the GAC is disabled by setting the AssemblySearchPath_UseGAC property to false.
• Treating the reference's Include as a real file name is disabled by setting the AssemblySearchPath_UseRawFileName property to false.
• Checking the application's output folder is disabled by setting the AssemblySearchPath_UseOutDir property to false.

Please could you clarify which four locations apply for the .NET SDK?

Separately, a numbered list might be clearer.

[fuguiKz]

I opened a docs PR in MicrosoftDocs/visualstudio-docs to clarify which 4 AssemblySearchPaths placeholders are used by default for SDK-style projects (and to switch the list to a numbered format):

MicrosoftDocs/visualstudio-docs#11175

[fuguiKz]

FYI (so you don’t have to wait for the docs PR to merge): for SDK-style projects the default AssemblySearchPaths list is:

• {CandidateAssemblyFiles}
• {HintPathFromItem}
• {TargetFrameworkDirectory}
• {RawFileName}

The docs PR adds this explicitly, and also mentions that you can see the effective SearchPaths value in the ResolveAssemblyReference inputs in MSBuild Structured Log Viewer (or via msbuild /pp).

[fuguiKz]

The docs PR clarifying the default AssemblySearchPaths placeholders for SDK-style projects has been merged: MicrosoftDocs/visualstudio-docs#11175

This should address the documentation request in this issue; feel free to close if no further action is needed.