我有我的web api,我添加了web api help pages来自动生成我的文档 . 它适用于列出我的参数的方法,但我有一个这样的方法:
public SessionResult PostLogin(CreateSessionCommand request)
并且,在我的帮助页面上,它只列出了属性部分中的命令参数 . 但是,在示例请求部分中,它列出了我的 CreateSessionCommand
类的所有属性 .
参数名称|说明|附加信息请求|没有可用的文档 . |在请求正文中定义此参数 .
我希望它能列出我的 CreateSessionCommand
类中的所有属性 . 是否有捷径可寻?
3 回答
这应该是@Josh回答的补充 . 如果您不仅要列出模型类中的属性,还要包含每个属性的文档,则应按如下方式修改Areas / HelpPage / XmlDocumentationProvider.cs文件:
和CustomParameterInfo类也应该保留属性信息:
所以,我设法为这个问题设计了一个解决方法,万一有人感兴趣 .
在HelpPageConfigurationExtensions.cs中,我添加了以下扩展方法:
这是我使用的参数信息实例类
然后,我们在扩展类中的另一个方法中调用扩展
必须将用于此的注释添加到控制器方法,而不是类对象的属性 . 这可能是因为我的对象是外部库的一部分
目前不支持开箱即用 . 以下bug与此有关:http://aspnetwebstack.codeplex.com/workitem/877