c# - 如何在 C# 摘要中包含 html 标记，以便将其作为文本处理（不解析为 XML）？

Question

我正在用 C# 编写一个 HTML 解析器，并希望在摘要 XML 块中包含它处理的 HTML 示例。如何防止 < 和 > 字符弄乱 Visual Studio 2008 的自动文档？

例子：

  /// <summary>
  /// Creates a FlowSegment based on an HTML code, i.e. <bold>
  /// </summary>
  /// <param name="code"></param>
  /// <returns></returns>
  public FlowSegment(string code)
  {

不幸的是，该示例导致此构造函数的工具提示（部分）显示：

XML comment includes invalid XML

而不是总结评论。

如何转义 < 和 > 字符？

Answer 1

我找到的最佳解决方案是更改它以便将 <<和 >替换为>

在XML 规范中找到。

这使得示例如下所示：

  /// <summary>
  /// Creates a FlowSegment based on an HTML code, i.e. &lt;bold&gt;
  /// </summary>
  /// <param name="code"></param>
  /// <returns></returns>
  public FlowSegment(string code)
  {

这使得所需的工具提示正确显示。