时间戳

首页 > 解决方案 > Sandcastle isignoring my invalid XML comments file 由于 MS 组件中的一些错误 HTML

.net - Sandcastle isignoring my invalid XML comments file 由于 MS 组件中的一些错误 HTML

问题描述

我正在使用最新版本的 Sandcastle 来记录我的项目。帮助文件缺少大量内容，我的日志中有此错误：

Ignoring invalid XML comments file '\System.Configuration.ConfigurationManager.xml'.  Reason: The 'br' start tag on line 977 position 39 does not match the end tag of 'p'.

在创建该文件时查看该文件，我看到了这个 XML 片段：

<member name="P:System.Configuration.SectionInformation.ForceSave">
      <summary>Gets or sets a value that indicates whether the associated configuration section will be saved even if it has not been modified.</summary>
      <returns><p sourcefile="System.Configuration.ConfigurationManager.yml" sourcestartlinenumber="1" sourceendlinenumber="3"><p sourcefile="System.Configuration.ConfigurationManager.yml" sourcestartlinenumber="1" sourceendlinenumber="1"><code>true</code> if the associated <xref href="System.Configuration.ConfigurationSection"></xref> object will be saved even if it has not been modified; otherwise, <code>false</code>. The default is <code>false</code>.  </p>
 <block subset="none" type="note"><p>**<br>** If the configuration file is saved (even if there are no modifications), ASP.NET restarts the application.  </p>
<p sourcefile="System.Configuration.ConfigurationManager.yml" sourcestartlinenumber="5" sourceendlinenumber="5"></block></p>
</returns>
    </member>

Visual Studio 中的 Intellisense 突出显示了我认为应该是 <br/> 的 <br> 标签的问题。

两个问题 - 我如何在我的帮助文件中解决这个问题，因为这是 MS 提供的内容？

MS 内容的在线页面在这里： https ://docs.microsoft.com/en-us/dotnet/api/system.configuration.sectioninformation.forcesave?view=netframework-4.8

我可以在哪里向 Microsoft 报告此问题？

标签： .netsandcastle

解决方案

推荐阅读