2

テンプレート クラスを返す ASP.NET Web API がありますが、戻り値の型に関するドキュメントを正しく提供する Web API ヘルプ ページを取得できません。

次の Model クラスがあるとします。

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 アクションが を返すことを宣言し、MyTypeOfFooMyType の 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