Web API 2帮助页面是否没有处理XML文档标记?

时间:2014-04-10 10:27:08

标签: c# asp.net-web-api xml-documentation asp.net-web-api-helppages

我正在尝试在我的XML文档标记中使用<see cref="">标记作为我的API,但它们在帮助页面中显示为空白。

所以,对于描述,我想说:

“获取或设置关联的项目的值。”

其中 Item 是指向API中另一个对象的链接。

相反,我得到了:

“获取或设置关联的值。”

因此忽略了<see cref="">标记。我甚至尝试使用here中的示例,以防我的声明错误,但这也不起作用。

还有其他人有这个问题吗?新Web API 2帮助页面支持的XML文档标记的级别是多少?有没有人知道是否可以手动添加对此的支持?如果没有?

1 个答案:

答案 0 :(得分:0)

我还没有遇到过这个问题,但我建议你

  • 发布一个说明行为的简单示例,以及您获得的结果

  • 检查可能表明XML文档标记有问题的构建警告。

例如,您说您正在使用<see cref="">您是否在cref属性中添加了有效的标识符并关闭了see标记 - 例如<see cref="MyClass.MyMethod" />