swagger-uiページにコントローラの名前を変更する方法はありますか？

Question

私はWebApiプロジェクトでswaggerとswagger-uiの使用を可能にするためにSwashbuckleを使用しています。

次の画像では、swagger-uiページに表示されている2つのコントローラを確認できます。これらはC＃コードのように名前が付けられていますが、ここに表示されているものを変更する方法があるかどうか疑問に思っていましたか？

これは主に、ManagementDashboardWidgetがユーザーフレンドリーな名前ではないため、ユーザーフレンドリーに変更したいからです。

Answer 1

あなたはそのためのタグを使用することができます。デフォルトでは、Swashbuckleはすべての操作にコントローラ名のタグを追加します。 SwaggerOperationAttributeで上書きすることができます。たとえば、次の行は、タグのテストで、デフォルトのタグ、値を置き換えます。

public class ValuesController : ApiController 
{ 
    [SwaggerOperation(Tags = new[] { "Test" })] 
    public IHttpActionResult Get() 
    { 
     // ... 
    } 
} 

Get動作について、グループTestに配置されます。

操作を複数のグループに表示する場合は、さらにタグを追加できます。例えば：

[SwaggerOperation(Tags = new[] { "Test", "Release1" })] 

はグループTestとRelease1でGet操作を配置します。