文明的进步我的进步都是从懒开始的，关于net中swagger排序以及官方文档

发表于2022-08-17|更新于2024-12-31|c#

|浏览量:

简书链接:文明的进步我的进步都是从懒开始的，关于net中swagger排序以及官方文档
文章字数：520,阅读全文大约需要2分钟
最怕的是没有目标，最怕的是一个人明明可以高效的处理却偏偏用最低效的办法。

我目前遇到的问题是接口太多，调试还需要找，不断地下滑，swagger文档所有接口都在一起，我最新写的接口肯定希望再第一个的，

搜索swagger排序，百度找到的只有java 的注解排序，但是后面无意中受到了分组，分组一定程度上可以解决问题，

最后找到了这篇不错的文章

https://www.cnblogs.com/ives/p/swagger.html
实现顺序通过修改分类枚举即可。

实现方法简单，需要 3个类

增加入口

定义注解

关于更多骚操作，包括备注显示参考官方源码
AspNetCore.Docs/aspnetcore/tutorials/web-api-help-pages-using-swagger/samples/7.x/NSwagSample/Controllers/TodoController.cs at main · dotnet/AspNetCore.Docs (github.com)

Swagger UI
Swashbuckle 和 ASP.NET Core 入门 | Microsoft Learn

文章作者: 情随事迁

文章链接: https://lozn.top/2022/08/17/%E6%96%87%E6%98%8E%E7%9A%84%E8%BF%9B%E6%AD%A5-%E6%88%91%E7%9A%84%E8%BF%9B%E6%AD%A5-%E9%83%BD%E6%98%AF%E4%BB%8E%E6%87%92%E5%BC%80%E5%A7%8B%E7%9A%84%EF%BC%8C%E5%85%B3%E4%BA%8E-net%E4%B8%ADswagger%E6%8E%92%E5%BA%8F%E4%BB%A5%E5%8F%8A%E5%AE%98%E6%96%B9%E6%96%87%E6%A1%A3/

版权声明: 本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源情迁博客！

赞助

alipay
wechat

相关推荐

NETCOREAOTSystemNotSupportedExceptionMicrosoftExtensionsInter

简书链接:NETCOREAOTSystemNotSupportedExceptionMicrosoftExtensionsInter文章字数：358,阅读全文大约需要1分钟 123456789101112131415161718Connection id "0HMVI4QB7212P", Request id "0HMVI4QB7212P:00000068": An unhandled exception was thrown by the application.Exception: System.NotSupportedException: 'Microsoft.Extensions.Internal.PropertyHelper+ByRefFunc`2[System.Collections.Generic.KeyValuePair`2[System.String, Microsoft.Extensions.Primitives.StringValues], System.String]' is missing...

net前端数字作为key输出json，自动排序以及前端也自动排序问题

简书链接:net前端数字作为key输出json，自动排序以及前端也自动排序问题文章字数：499,阅读全文大约需要1分钟 01 02 03这样的返回会自动排序变成了10 11 08 09 放到后面了，干脆变成字符串，然后强制定义http返回json,不过直接返回文本也可以 12345678var jsonresult = new ContentResult { Content = result, ContentType = "application/json" }; return jsonresult; 改为文本text/plain没有了，这就很离谱，result本身是没问题的，为啥返回换成json就有问题，这里没涉及到jobject的操作呀，只是告诉它，我需要返回什么文本类型，打开接口查看发现后端排序解决了，但是发现前端更可恶，从08...

netcoreapijson时间序列化返回多种场景踩坑

简书链接:netcoreapijson时间序列化返回多种场景踩坑文章字数：111,阅读全文大约需要1分钟 1234567891011121314builder.Services.AddControllers().AddJsonOptions(options =>{ options.JsonSerializerOptions.Converters.Add(new MyDateTimeConverter()); options.JsonSerializerOptions.Converters.Add(new DateTimeNullableConverter()); options.JsonSerializerOptions.AddContext<MyJsonContext>();//处理aot});builder.Services.AddControllers().AddNewtonsoftJson(options =>//install-package...

netcoreapi配置跨域几种常见样板代码NoAccessControlAllowOriginheaderispre

简书链接:netcoreapi配置跨域几种常见样板代码NoAccessControlAllowOriginheaderispre文章字数：306,阅读全文大约需要1分钟 as been blocked by CORS policy: No Access-Control-Allow-Origin header is present on the requested resource. .net core api 在写低代码实现前端调用core api接口时出现了跨域问题,发现问题出在后端接口，或者说是被访问的接口,在前端添加<meta http-equiv="Access-Control-Allow-Origin" content="*" />是没效果的，因为问题是访问此页面出现错误，问题就从此页面此接口解决问题，上面的报错地址是core api写的，因此从它入手解决问题。 1234567891011121314151617181920212223builder.Services.AddCors(c =>{ ...

netcorec忽略证书解决解决TheSSLconnectioncouldnotbeestablished报错

简书链接:netcorec忽略证书解决解决TheSSLconnectioncouldnotbeestablished报错文章字数：290,阅读全文大约需要1分钟在自己电脑能正常访问，在远程服务器上部署发现无法访问微信https网址。检查了远程服务器的时间也是正常的，具体啥原因就懒得钻研了测试用exe直接打开的方式部署正常，那么估计问题出在iis的部署方式的配置问题了，和之前遇到的配置跨域无效问题类似。如果以web.config iis启动则这么配置 12345678910<configuration> <system.net> <settings> <servicePointManager checkCertificateName="false" checkCertificateRevocationList="false" /> </settings> ...

netwebapijson参数错误的json格式和返回结果响应码定制

简书链接:netwebapijson参数错误的json格式和返回结果响应码定制文章字数：190,阅读全文大约需要1分钟经过测试发现要获取详细信息需要通过 1 builder.Services.AddControllers().ConfigureApiBehaviorOptions(setupAction => setupAction.InvalidModelStateResponseFactory = context =>{ var problemDetail = new Microsoft.AspNetCore.Mvc.ValidationProblemDetails(context.ModelState) { Type = “无所谓”, Title = “数据验证失败”, Status = StatusCodes.Status200OK, Detail = “请看详细说明”, Instance...

评论