我正在為 C# 專案撰寫一個小型分析器,用于檢查 XML 檔案生成是否存在并正確設定。有兩個選項可用于指定 XML 檔案:
- 較舊的
DocumentationFile選項 - 較新的
GenerateDocumentationFile標志。如果該標志設定為 true,MSBuild 應在專案的輸出目錄中生成一個帶有專案名稱的 XML 檔案檔案。
可以在專案檔案中明確指定這兩個選項嗎?這些選項的值會被合并還是其中一個選項會被忽略?
uj5u.com熱心網友回復:
它們都不需要設定。如果DocumentationFile不為空,則將在 MSBuild 目標中GenerateDocumentationFile設定為true。
如果設定GenerateDocumentationFile為true,則將DocumentationFile根據專案檔案名設定默認值。
相關的 MSBuild 目標
<!-- Handle XML documentation file settings -->
<PropertyGroup Condition="'$(GenerateDocumentationFile)' == ''">
<GenerateDocumentationFile Condition="'$(DocumentationFile)' == ''">false</GenerateDocumentationFile>
<GenerateDocumentationFile Condition="'$(DocumentationFile)' != ''">true</GenerateDocumentationFile>
</PropertyGroup>
<PropertyGroup Condition="'$(GenerateDocumentationFile)' == 'true' and '$(DocumentationFile)' == ''">
<DocumentationFile Condition="'$(MSBuildProjectExtension)' == '.vbproj'">$(AssemblyName).xml</DocumentationFile>
<DocumentationFile Condition="'$(MSBuildProjectExtension)' != '.vbproj'">$(IntermediateOutputPath)$(AssemblyName).xml</DocumentationFile>
</PropertyGroup>
<PropertyGroup Condition="'$(GenerateDocumentationFile)' != 'true'">
<DocumentationFile />
</PropertyGroup>
轉載請註明出處,本文鏈接:https://www.uj5u.com/shujuku/363144.html
