在编写项目文件或者 MSBuild Target 文件的时候,我们经常会使用 <Foo Include="Identity" />
来定义集合中的一项。在定义的同时,我们也会额外指定一些属性。
然而这些属性如何拿到并且使用呢?本文将介绍使用方法。
将下面的代码放到你项目文件的末尾,最后一个 </Project>
的前面,可以在编译的时候看到两个新的警告。
1
2
3
4
5
6
7
8
<Target Name="Xxx" AfterTargets="AfterBuild">
<ItemGroup>
<WalterlvX Include="@(Compile)" />
<WalterlvY Include="%(Compile.FileName)" />
</ItemGroup>
<Warning Text="@(WalterlvX)" />
<Warning Text="@(WalterlvY)" />
</Target>
在定义 WalterlvX
集合的时候,我们使用了 @(Compile)
来获取所有需要编译的文件。
在定义 WalterlvY
集合的时候,我们使用了 %(Compile.FileName)
来获取编译文件的文件名。
于是,你在警告信息中看到的两个警告信息里面,一个输出了 Compile
集合中每一项的标识符(通常是相对于项目文件的路径),另一个输出了每一个 Compile
项中的 FileName
属性。FileName
属性是 Compile
会被 Microsoft.NET.Sdk 自动填充。
需要注意,如果 %
得到的项中某个属性为空,那么这一项在最终形成的新集合中是不存在的。
所以,如果存在可能不存在的属性,那么建议先进行拼接再统一处理拼接后的值:
1
2
3
4
5
6
<Target Name="Xxx" AfterTargets="AfterBuild">
<ItemGroup>
<Walterlv Include="@(Compile)=%(Compile.CopyToOutputDirectory)" />
</ItemGroup>
<Warning Text="@(Walterlv)" />
</Target>
这里的 CopyToOutputDirectory
不是一个总是会设置的属性。
本文会经常更新,请阅读原文: https://blog.walterlv.com/post/msbuild-referencing-metadata.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。
本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名 吕毅 (包含链接: https://blog.walterlv.com ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系 ([email protected]) 。