Warm tip: This article is reproduced from serverfault.com, please click
c# swagger swashbuckle swagger-ui

c#-有没有办法在swagger-ui页面中更改控制器的名称？

(c# - Is there a way change the Controller's name in the swagger-ui page?)

发布于 2016-05-06 15:29:14

我正在使用Swashbuckle在WebApi项目中启用swagger和swagger-ui。

在下图中，你可以看到swagger-ui页面中显示的两个控制器。它们的名称与C＃代码中的名称相同，但是我想知道是否有一种方法可以更改此处显示的内容？

主要是因为你看到ManagementDashboardWidget的不是用户友好名称，所以我想将其更改为用户友好。

swagger-ui

Questioner
XN16
Viewed
11
分享
venerik 2016-05-09 20:06:15

你可以为此使用标签。默认情况下，Swashbuckle将带有控制器名称的标签添加到每个操作中。你可以使用来覆盖它SwaggerOperationAttribute。例如，下一行用标签Test替换默认标签Values：

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

Get现在将把该操作放入组中Test。

如果你希望该操作显示在多个组中，则可以添加更多标签。例如：

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

会将Get操作分组Test和Release1。

XN16 2016-05-09 15:36:04

那正是我想要的...我只是从未在那部分上找到太多文档。非常感谢。

jtate 2019-04-18 15:54:01

此方法有效，但仍将控制器名称留在UI中作为标记，但在其下没有任何操作。例如，说我有ABCController但我已添加[SwaggerOperation(Tags = new[] { "DEF" })]到所有路线，用户界面显示“ ABC”和“ DEF”，但“ ABC”下没有任何内容。我们如何彻底摆脱“ ABC”？

Diego Baranowski 2021-01-16 00:04:31

看看下面我的回答。希望对您有帮助！

热门帖子

1
🇭🇰关于香港开户和旅游简单但有用的分享（附白拿 HKD 300 方法）
2
家庭 or 个人用的 NAS 有什么可以推荐的吗？
3
远程兼职 Web3 工程师
4
请假理由填写问题
5
[烟台大樱桃] 人生不只有上班一条路，被裁后决定专心转行做水果
6
这大约是独立开发的顶流了吧， v 友们怎么看
7
6 年软开求职 国外务工求职比如澳新美等地
8
银行功能测试工程师
9
V 友们 今年刚需 需要买车 预算 20 出头 极氪 007 可以入吗
10
黑群和白群的差异，如何选择？

热门github

1
Implementation of paper - YOLOv9: Learning What You Want to Learn Using Programmable Gradient Information (翻译：论文实现——YOLOv9: Learning What You Want to Learn using Programmable Gradient Information（利用可编程梯度信息学习您想学的内容）)
2
A Windows and Office activator using HWID / Ohook / KMS38 / Online KMS activation methods, with a focus on open-source code and fewer antivirus detections. (翻译：使用 HWID / KMS38 / Online KMS 激活方法激活 Microsoft 产品的脚本集合，重点是开源代码、较少的防病毒检测和用户友好性。)
3
Get up and running with Llama 2, Mistral, Gemma, and other large language models. (翻译：启动并运行 Llama 2、Mistral、Gemma 和其他大型语言模型。)
4
该项目可以让你通过订阅的方式使用Cloudflare WARP+，自动获取流量。This project enables you to use Cloudflare WARP+ through subscription, automatically acquiring traffic.
5
Multi functional app to find duplicates, empty folders, similar images etc. (翻译：多功能应用程序可查找重复项、空文件夹、相似图像等。)
6
Xray panel supporting multi-protocol multi-user expire day & traffic & ip limit (Vmess & Vless & Trojan & ShadowSocks & Wireguard) (翻译：Xray面板支持多协议多用户到期日&流量&IP限制（Vmess & Vless & Trojan & ShadowSocks & Wireguard)
7
The Free Software Media System (翻译：Jellyfin 是一个免费软件媒体系统，可让您控制管理和流式传输您的媒体。它是专有 Emby 和 Plex 的替代方案，通过多个应用程序从专用服务器向最终用户设备提供媒体。)
8
lightweight, standalone C++ inference engine for Google's Gemma models. (翻译：适用于 Google Gemma 模型的轻量级独立 C++ 推理引擎。)
9
📚 Freely available programming books (翻译：📚 免费提供的编程书籍)
10
A collective list of free APIs (翻译：免费 API 的集合列表)
11
1️⃣🐝🏎️ The One Billion Row Challenge -- A fun exploration of how quickly 1B rows from a text file can be aggregated with Java (翻译：十亿行挑战 —— 使用 Java 对文本文件中的 10 亿行数据进行聚合的有趣探索)
12
🎓 Path to a free self-taught education in Computer Science! (翻译：🎓计算机科学免费自学教程！)
13
Curso para aprender el lenguaje de programación Python desde cero y para principiantes. 75 clases, 37 horas en vídeo, código, proyectos y grupo de chat. Fundamentos, frontend, backend, testing, IA... (翻译：从零开始学习 Python 编程语言的课程，适合初学者)
14
This repository contains System Design resources which are useful while preparing for interviews and learning Distributed Systems (翻译：该存储库包含系统设计资源，在准备面试和学习分布式系统时非常有用)
15
Mamba is a new state space model architecture showing promising performance on information-dense data such as language modeling, where previous subquadratic models fall short of Transformers. It is based on the line of progress on structured state space models, with an efficient hardware-aware design and implementation in the spirit of FlashAttention. (翻译：Mamba 是一种新的状态空间模型架构，在信息密集型数据（例如语言建模）上显示出良好的性能，而之前的二次模型在 Transformers 方面存在不足。它基于结构化状态空间模型的进展，并本着FlashAttention的精神进行高效的硬件感知设计和实现。)