Cài đặt Riêng tư làm gì trên ProjectReference trong tệp dự án MSBuild?

Tôi đã thấy điều này trong một tệp dự án ngày hôm trước:

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

Mọi nút trong một ProjectReferencedường như là tự giải thích (tệp dự án được tham chiếu, GUID, tên để hiển thị trong trình khám phá giải pháp và liệu dự án hiện tại có nên liên kết đến dự án được tham chiếu hay không) ngoại trừ Privatevà trang Mục dự án MSBuild chung không ' t tài liệu giá trị này. (Có một Privatethiết lập tài liệu cho Referencehơn ProjectReference- nhưng nó có Never, Alwaysvà PreserveNewestcài đặt, không đúng sự thật và sai)

Cài đặt này làm gì?

Các Privatethẻ duy trì sử dụng ghi đè vào "Copy Local" hộp kiểm trong thư mục tài liệu tham khảo Visual Studio. Điều này kiểm soát xem tham chiếu có được sử dụng từ GAC hay nó sẽ sao chép hội đồng tham chiếu vào thư mục xây dựng.

Mặc dù tôi không thể tìm thấy bất kỳ tài liệu MSDN nào về hiệu ứng này (điều ngạc nhiên là quelle), nhưng điều đó là hiển nhiên từ hành vi và từ nhận xét vềMicrosoft.Common.CurrentVersion.targets:1742 nơi nó được áp dụng:

Điều này được ghi lại trong MSDN> Các hạng mục dự án MSBuild chung , và được thể hiện rõ ràng từ hành vi và từ nhận xét ởMicrosoft.Common.CurrentVersion.targets:1742 nơi nó được áp dụng:

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

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

Tôi chỉ muốn nói rằng <Private>false</Private>(mà bạn có thể áp dụng cho ProjectReferences) có thể không hoạt động khi sử dụng <MSBuild Projects="$(MSBuildProjectFullPath)" Targets="Publish" Properties="$(_MSBuildProperties)" />và dự án $(MSBuildProjectFullPath)có ProjectReferences có <None><CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory></None> . Tôi đã đọc mã nguồn xung quanh https://github.com/dotnet/sdk/blob/master/src/Tasks/Microsoft.NET.Build.Tasks/targets/Microsoft.NET.Publish.targets và tìm ra giải pháp. Bạn cần xác định _GetChildProjectCopyToPublishDirectoryItems=falsenên một ví dụ sẽ là:<MSBuild Projects="$(MSBuildProjectFullPath)" Targets="Publish" Properties="TargetFramework=$(TargetFramework);_GetChildProjectCopyToPublishDirectoryItems=false" />