是XML文档标记不被网页API 2帮助页面处理？ [英] Are XML documentation tags not being handled by Web API 2 help pages?

问题描述

我试图用＆LT;见CREF =＆GT; 在我的API我的XML文档标记的标签，但他们都上来了帮助空白页面。

I'm trying to use <see cref=""> tags in my XML documentation tags for my API, but they are coming up blank in the Help pages.

因此​​，对于描述我想它说：

So, for a Description I'd like it to say:

获取或设置值相关的项目的。

"Gets or sets the value for the associated Item."

其中的项目的是在API中对另一个对象的链接。

Where Item is a link to another object in the API.

相反，我越来越：

获取或设置值相关联的。

"Gets or sets the value for the associated ."

所以＆LT;见CREF =＆GT; 标签被忽略。我甚至已经利用例子这里以防万一我的声明是错误的尝试，但没'T的工作无论是。

So the <see cref=""> tag is being ignored. I've even tried using examples from here just in case my declaration was wrong, but that didn't work either.

有其他人有这个问题？新的Web API 2帮助页面中支持哪些级别的XML文档的标签？有谁知道是否有可能以手动添加这种支持，如果不是？

Has anybody else had issues with this? To what level are XML documentation tags supported in the new Web API 2 Help Pages? Does anybody know if it's possible to add support for this manually, if not?

推荐答案

我还没有这个问题，但我建议你

I haven't had issues with this, but I suggest you

• 与您取得结果发布一个简单的示例，说明了行为，共同

• Post a simple sample that illustrates the behavior, together with the result you obtain

检查建立警告可能表示你的XML文档标记问题。

Check for build warnings that might indicate problems with your XML documentation tags.

举例来说，你说你正在使用＆LT;见CREF =＆GT; 您把一个有效的标识符在CREF属性和关闭见标签 - 例如＆LT;见CREF =MyClass.MyMethod/＆GT;

For example, you say you're using <see cref=""> Are you putting a valid identifier in the cref attribute and closing the see tag - e.g. <see cref="MyClass.MyMethod" />?

这篇关于是XML文档标记不被网页API 2帮助页面处理？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！