具有Enum参数的方法的Web API帮助页面

Question

我正在使用Web API帮助页面生成器生成我的API文档.但问题是帮助页面生成器无法为具有Enum参数的方法生成文档.对象和动态类型的参数也会出现这种情况.

这是我的方法:

public HttpResponseMessage Get(Status status, DateTime? date = null)
{
    ...
}

enum Status
{
    Avaliable,
    Busy,
    Canceled,
    Failed,
    Sent
}

以下是生成文档:

GET api/StatusCheck?date={date}

但正确的形式是:

GET api/StatusCheck?status={status}&date={date}

当我转到API模型文档时,参数就在那里,但是没有描述.

就像这样:

GET api/StatusCheck?date={date}

Unavaliable.

Request
Parameters

Name            Description
status          Unavaliable.
date            Unavaliable.

这是帮助页面生成器中的BUG吗？如何修复我的页面示例？

Answer 1

这实际上是一个错误，已于今年 4 月修复。以下是与此相关的问题。

http://aspnetwebstack.codeplex.com/workitem/312