asp.net > swagger
環境
VS:VisualStudio2017
フレームワーク: .Net Framework 4.6
Swaggerをインストール
「ツール」→「NuGetパッケージマネージャー」→「NuGetパッケージの管理」
検索にSwashbuckle
実行
F5で実行する。
URLの後ろに「/swagger」を付けてアクセスする。
例)
http://localhost:60437/swagger/ui/index#/Values
以下のような画面が表示されれば成功
XMLコメントを表示する
以下のファイルを編集
App_Start > SwaggerConfig.cs
以下の文のコメントを外す
c.IncludeXmlComments(GetXmlCommentsPath());
SwaggerConfig.csの最後尾くらいに以下のメソッドを追加
private static string GetXmlCommentsPath()
{
return string.Format(@"{0}\bin\SwaggerDemo.XML", System.AppDomain.CurrentDomain.BaseDirectory);
}
XMLの名称はアセンブリ名と一致させる。
この例では以下になる。
return string.Format(@"{0}\bin\SwaggerDemo.XML", System.AppDomain.CurrentDomain.BaseDirectory);
XMLコメント
以下のような容量でXMLコメントを付ける
/// <summary>
/// valuesをゲット
/// </summary>
/// <returns></returns>
// GET api/values
public IEnumerable<string> Get()
{
return new string[] { "value1", "value2" };
}
実行
XMLコメントが表示される。
Swaggerの見た目変更
以下のファイルを編集
App_Start > SwaggerConfig.cs
以下の行を外し、containingAssemblyをthisAssemblyに変更する。
(thisAssemblyは SwaggerConfig.csの先頭らへんで定義されている)
c.CustomAsset("index", thisAssembly, "NameSpace.SwaggerExtensions.index.html");
NameSpaceには以下プロジェクト・プロパティで表示される規定の名前空間に表示されている名前を設定する。
この例では以下になる。
c.CustomAsset("index", thisAssembly, "ECommerceName.SwaggerExtensions.index.html");
Index.htmlの配置
SwaggerExtensionsフォルダを作成し、index.htmlファイルを作成する。
index.htmlファイルは以下をベースにする。
Swashbuckle/index.html at v5.5.3 · domaindrivendev/Swashbuckle
ビルドアクション
index.htmlのプロパティにて、ビルドアクションを埋め込みリソースに変更する
参考
c# - swagger-ui returns 500 after deployment - Stack Overflow
How to customize Swagger UI in ASP.NET Web API – Umamaheswaran
ASP.NET Web API2.2で、Swagger(Swashbuckle 5.1.5)を使う - BEACHSIDE BLOG
Author And Source
この問題について(asp.net > swagger), 我々は、より多くの情報をここで見つけました https://qiita.com/sugasaki/items/a841a5a657f53b6522d2著者帰属:元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。
Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .