問題タブ [asp.net-web-api-helppages]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票する
1 に答える
581 参照

asp.net-web-api - ASP.NET Web API ヘルプ ページでは、F# レコード タイプに関する不完全なドキュメントが生成されます

ASP.NET Web API ヘルプ ページ プロジェクトでは、Web API コントローラー アクションのパラメーターまたは結果の型として使用される F# レコード型の完全なドキュメントは作成されていません。メンバーはリストされますが、XML コメント内の要約情報は生成されたドキュメントには表示されません。これを修正するにはどうすればよいですか?

次の F# レコード タイプが、Web API アクション メソッドのパラメーターまたは結果タイプとして使用されているとします。

期待される出力

このタイプの生成されたヘルプ ページ ドキュメントには、このメンバーの説明列に概要情報が含まれている必要があります。

実際の出力

実際に見られるのは、要約情報がまったくないことです。

仕様

この問題は、次の特定のテクノロジに関連して発生します。

  • Microsoft ASP.NET Web API ヘルプ ページ v5.1.1;
  • Visual Studio Professional 2013 (アップデート 1); と
  • F# 3.1 コンパイラ。

自己回答にもかかわらず、私が現在持っているものは実際にはマスタードをカットしていないため、フロアはより良い解決策に対して広く開かれています.

0 投票する
1 に答える
1161 参照

asp.net-web-api - Web API ヘルプ ページ - ユーザー固有の応答タイプ

ユーザーに基づいて異なる応答を出力する API を開発しています。現在、ResponseType 属性を使用して、返される応答のタイプを記述していますが、これにより、1 つのタイプの応答しか指定できず、ユーザー。

ヘルプ ページをカスタマイズして、ユーザーが受け取る応答の種類を表示する方法はありますか?

0 投票する
1 に答える
649 参照

c# - XML ドキュメント タグは Web API 2 ヘルプ ページで処理されませんか?

<see cref="">API の XML ドキュメント タグでタグを使用しようとしていますが、ヘルプ ページで空白になります。

したがって、説明については、次のように言いたいと思います。

「関連付けられたItemの値を取得または設定します。」

Itemは、API 内の別のオブジェクトへのリンクです

代わりに、私は得ています:

関連する の値を取得または設定します。

そのため、<see cref="">タグは無視されています。宣言が間違っていた場合に備えて、こちらの例を使用してみましたが、それもうまくいきませんでした。

他の誰かがこれに問題を抱えていますか? 新しい Web API 2 ヘルプ ページでは、XML ドキュメント タグはどのレベルまでサポートされていますか? これを手動でサポートを追加できるかどうかを知っている人はいますか?

0 投票する
4 に答える
15439 参照

c# - インポートに適した WebApi HelpPages を使用して、WebApi2 プロジェクトから JSON Postman コレクションを生成する方法

Postmanは、安らかな Web サービスを簡単にテストするために使用できるツールです。

Asp.Net プロジェクトがWebApiと組み合わせてWebApiを使用している場合、公開された RESTful Web サービスのドキュメントを自動的に生成できます。

この自動生成されたドキュメントは優れていますが、アクセシビリティを追加することでさらに良くなる可能性があります。

これらのテクノロジーをどのように組み合わせて、Postman にインポートできる JSON ファイルを生成できますか?

0 投票する
1 に答える
1492 参照

c# - API モデルの応答モデルの文書化

API を文書化していますが、作成した ViewModel に応答形式をリンクする方法を考えています。ViewModel には、ユーザーに閲覧してもらいたい注釈があります。問題は、コントローラーが実際のモデル自体ではなくHttpResponseMessageを返すことです。そのため、WebAPI ヘルプ ページでは、これについての説明を省略しています。

API ヘルプ ページ

HelpPageConfig.cs に以下を追加しました。

これを回避し、APIExplorer を使用してヘルプ ページにリンクを作成するにはどうすればよいですか。または、これは手動で行う必要がありますか?

コントローラーの例。