3

序章

このチュートリアルに従って、ASP.NET Web API ヘルプ ページをセットアップしました。

使用する<package id="Microsoft.AspNet.WebApi.HelpPage" version="5.2.3" targetFramework="net452" />

ドキュメントは問題ないようですが、空のモデル プロパティの説明が表示されます。

それらは、コントローラーのメソッド/エンドポイントとモデルの詳細ドキュメントの両方で空です。

コントローラーメソッドの例

/// <summary>
/// POST: api/remitent
/// </summary>
/// <param name="remitent"></param>
public void Post([FromBody]Remitent remitent)
{

}

モデル プロパティの例

/// <summary>
/// First name property summary
/// </summary>
[Required]
[MaxLength(49)]     
public string FirstName { get; set; }

結果

ドキュメントのモデル プロパティの説明は、FirstName プロパティの概要で埋められると思います。代わりに、説明列は空です: ここに画像の説明を入力


誰もそれを解決する方法を知っていますか?

4

2 に答える 2

2

Areas/HelpPage/App_Start/HelpPageConfig.cs の次のコード行のコメントを外しましたか:

config.SetDocumentationProvider(new XmlDocumentationProvider(
    HttpContext.Current.Server.MapPath("~/App_Data/XmlDocument.xml")));
于 2016-07-22T22:45:07.823 に答える
0

Microsoft.AspNet.WebApi.HelpPage の代わりに Swashbuckle を使用できますか。Swashbuckle は、API を探索するためのより優れたドキュメントと使いやすい UI を提供していると思います。これを使用して API をテストすることもできます。

于 2016-07-22T19:45:59.720 に答える