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

Question

考虑以下示例:

[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 中指定此行为，以便用户知道错误响应是什么样的？

Answer 1

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

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