帮助页面中的 C# WebAPI 多个 ResponseType -s答案

【问题标题】：C# WebAPI multiple ResponseType -s in Help Pages帮助页面中的 C# WebAPI 多个 ResponseType -s
【发布时间】：2017-07-14 11:06:19
【问题描述】：

考虑以下示例：

[ActionName("SomeTestAction")]
[ResponseType(typeof(SomeObject))]

public IHttpActionResult SomeTestAction(string id)
{

  SomeObject o = SomeMethod(id);

  if (o == null)
  {
      var message = string.Format("Nothing found for id = {0}", id);
      HttpError err = new HttpError(message);
      return Content(HttpStatusCode.NotFound, err);
  }
  else
  {
      return Content(HttpStatusCode.OK, o);
  }

}

例如，根据数据库查询的结果，此方法可以有两个不同的 ResponseType -s。有没有办法在 WebAPI 的 HelpPages 中指定这种行为，以便用户知道错误响应的样子？

【问题讨论】：

标签： c# asp.net-web-api2

【解决方案1】：

正如here 所述，根据我的经验，我认为这是不可能的，因为生成的文档是静态的。

您必须选择是要返回匿名对象（在运行时解析多种类型）还是显式具有返回类型并支持文档详细信息。

【讨论】：