2

我有一个返回模板类的 ASP.NET Web API，但我无法获取 Web API 帮助页面来正确提供返回类型的文档。

假设我有以下模型类：

public class MyType<T>
{
  /// <summary>A list of T</summary>
  public List<T> MyList { get; set; }
}
public class Foo
{
  /// <summary>Bar string</summary>
  public string Bar { get; set; }
}

我的 API 操作如下所示

[ResponseType(typeof(MyType<Foo>))]
public IHttpActionResult Get()
{
  return Ok<MyType<Foo>>(new MyType<Foo>());
}

生成的 Web API 帮助页面随后声明 Get 操作返回 aMyTypeOfFoo并且不提供 MyType 的 XML 文档，它仅列出它包含的参数。可能是因为它不明白那MyTypeOfFoo是一样的MyType<Foo>。这个问题有什么已知的解决方案吗？

更新

创建一个伪类并返回它也不起作用。例如

/// <summary>My Foo Type</summary>
public class MyFooType : MyType<Foo>
{
}

[ResponseType(typeof(MyFooType)]
public IHttpActionResult Get()
{
  return Ok<MyFooType>(new MyFooType());
}

上述代码的文档输出缺少可用于继承属性的注释。

4

0 回答 0