Что делает параметр Private для ProjectReference в файле проекта MSBuild?

На днях я видел это в файле проекта:

<ProjectReference Include="Foo\Bar\Baz.csproj">
    <Project>{A GUID HERE}</Project>
    <Name>Baz</Name>
    <Private>False</Private> <!-- ??? -->
    <ReferenceOutputAssembly>False</ReferenceOutputAssembly>
</ProjectReference>

Каждый узел в по- ProjectReferenceвидимому, сам объяснительный (указанный файл проект, GUID, имя для отображения в обозревателе решений, и следует ли или нет текущего проект ссылается на ссылочном проект) , за исключением Private, и товаров общего проект MSBuild страница Безразлично» t задокументировать это значение. (Там есть Privateнастройка документированы для , Referenceа не ProjectReference- но у него есть Never, Alwaysи PreserveNewestнастройки, а не истинные и ложные)

Что делает этот параметр?

PrivateТег поддерживает пользовательское переопределение флажка «Копировать Local» в папке Visual Studio Ссылки. Это определяет, используется ли ссылка из GAC или будет ли скопирована указанная сборка в каталог сборки.

Хотя я не могу найти никакой документации MSDN по этому поводу (удивление quelle), это очевидно из поведения и из комментария,Microsoft.Common.CurrentVersion.targets:1742 где он применяется:

Это задокументировано в MSDN> Общие элементы проекта MSBuild и очевидно из поведения и из комментария, вMicrosoft.Common.CurrentVersion.targets:1742 котором оно применяется:

  <!--
    ============================================================

                                        ResolveAssemblyReferences

    Given the list of assemblies, find the closure of all assemblies that they depend on. These are
    what we need to copy to the output directory.

        [IN]
        @(Reference) - List of assembly references as fusion names.
        @(_ResolvedProjectReferencePaths) - List of project references produced by projects that this project depends on.

            The 'Private' attribute on the reference corresponds to the Copy Local flag in IDE.
            The 'Private' flag can have three possible values:
                - 'True' means the reference should be Copied Local
                - 'False' means the reference should not be Copied Local
                - [Missing] means this task will decide whether to treat this reference as CopyLocal or not.

        [OUT]
        @(ReferencePath) - Paths to resolved primary files.
        @(ReferenceDependencyPaths) - Paths to resolved dependency files.
        @(_ReferenceRelatedPaths) - Paths to .xmls and .pdbs.
        @(ReferenceSatellitePaths) - Paths to satellites.
        @(_ReferenceSerializationAssemblyPaths) - Paths to XML serialization assemblies created by sgen.
        @(_ReferenceScatterPaths) - Paths to scatter files.
        @(ReferenceCopyLocalPaths) - Paths to files that should be copied to the local directory.
    ============================================================
    -->

Я хочу просто заявить, что <Private>false</Private>(что вы можете применить к ProjectReferences) может не работать при использовании, <MSBuild Projects="$(MSBuildProjectFullPath)" Targets="Publish" Properties="$(_MSBuildProperties)" />и у проекта $(MSBuildProjectFullPath)есть ProjectReferences, которые есть <None><CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory></None> . Я прочитал исходный код https://github.com/dotnet/sdk/blob/master/src/Tasks/Microsoft.NET.Build.Tasks/targets/Microsoft.NET.Publish.targets и нашел решение. Вам необходимо определить, _GetChildProjectCopyToPublishDirectoryItems=falseнапример:<MSBuild Projects="$(MSBuildProjectFullPath)" Targets="Publish" Properties="TargetFramework=$(TargetFramework);_GetChildProjectCopyToPublishDirectoryItems=false" />