Web API 2帮助页面是否无法处理XML文档标记？

Question

我试图在我的API的XML文档标签中使用<see cref="">标签，但是它们在帮助页面上显示为空白。

所以，对于描述，我想说：“获取或设置关联项的值。”其中项是API中另一个对象的链接。

相反，我得到了：“获取或设置关联的值。”

因此，<see cref="">标签被忽略了。我甚至尝试使用这里的示例，以防我的声明有误，但也不起作用。

有人遇到过类似问题吗？新的Web API 2帮助页面支持XML文档标记的程度如何？如果不支持，是否有可能手动添加支持？

- Chris Paton

---

我们确实遇到了同样的问题，但是所有关于这个主题的博客文章似乎都已经过时了。 - Remy

我在http://stackoverflow.com/questions/26177104/asp-web-api-help-pages-links-to-other-pages/26255631#26255631中概述了一种方法。 - Stuart Moore

Answer 1

我自己没有遇到过这个问题，但是我建议你：

• 提供一个简单的示例，展示出现的行为以及你得到的结果

• 检查构建警告，这可能表明你的 XML 文档标记存在问题。

例如，你说你正在使用 <see cref="">，那么你是否在 cref 属性中放置了有效的标识符并关闭了 see 标签 - 例如 <see cref="MyClass.MyMethod" />？

- Joe

---

嘿，乔，我们遇到了相同的问题，而且似乎其他人也看到了这个问题。你有任何提示从哪里开始吗？ - Remy