O que a configuração privada faz em um ProjectReference em um arquivo de projeto MSBuild?

Eu vi isso em um arquivo de projeto outro dia:

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

Cada nó em um ProjectReferenceparece ser autoexplicativo (o arquivo de projeto referenciado, GUID, nome a ser mostrado no gerenciador de soluções e se o projeto atual deve ser vinculado ou não ao projeto referenciado) Private, exceto , e a página Itens do projeto MSBuild comuns não t documente esse valor. (Há um Privatecenário documentado para Reference, em vez de ProjectReference- mas tem Never, Always, e PreserveNewestconfigurações, não verdadeiros e falsos)

O que essa configuração faz?

A Privatemarca mantém a substituição do usuário na caixa de seleção "Copiar local" na pasta Referências do Visual Studio. Isso controla se a referência é usada do GAC ou se ele irá copiar o assembly referenciado para o diretório de compilação.

Embora eu não consiga encontrar nenhuma documentação do MSDN para esse efeito (quelle surpresa), é evidente pelo comportamento e pelo comentário emMicrosoft.Common.CurrentVersion.targets:1742 que é aplicado:

Isso está documentado em MSDN> Itens de projeto comuns do MSBuild e é evidente a partir do comportamento e do comentário emMicrosoft.Common.CurrentVersion.targets:1742 que é aplicado:

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

                                        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.
    ============================================================
    -->

Eu quero apenas afirmar, que <Private>false</Private>(que você pode aplicar a ProjectReferences) pode não funcionar ao usar <MSBuild Projects="$(MSBuildProjectFullPath)" Targets="Publish" Properties="$(_MSBuildProperties)" />e o projeto $(MSBuildProjectFullPath)tem ProjectReferences que têm <None><CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory></None> . Eu li o código-fonte em https://github.com/dotnet/sdk/blob/master/src/Tasks/Microsoft.NET.Build.Tasks/targets/Microsoft.NET.Publish.targets e encontrei a solução. Você precisa definir _GetChildProjectCopyToPublishDirectoryItems=falsepara que um exemplo seja:<MSBuild Projects="$(MSBuildProjectFullPath)" Targets="Publish" Properties="TargetFramework=$(TargetFramework);_GetChildProjectCopyToPublishDirectoryItems=false" />