.net framework MVC ，API， 支持OAS3

最新推荐文章于 2025-07-29 22:39:53 发布
原创 最新推荐文章于 2025-07-29 22:39:53 发布 · 364 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#NSwag #.net framework #openapi #OAS3 #swagger

本文档介绍了如何在.NET Framework MVC项目中集成Nswag中间件以支持OpenAPI3。通过Nswag，可以使用SwaggerUI3，但默认生成的specification仍为2.0。通过源码阅读，我们找到了将规格升级到3.0的方法，并成功实现了这一功能。

目前公司遇到一个项目，要在.net framework MVC的基础上，支持OpenAPI 3.
经过很多资料的查找和探索。试过很多方式，最后推荐如下方案
Nswag 中间件，RicoSuter/NSwag
至于怎么使用或者替换，网上有很多文档。找不到可以推荐看看这个 NSwag使用帮助
这样的话，目前可以用SwaggerUI3， 但是得到的sepcifation依然是2.0。
所以需要加这么一句话。通过读源码发现。
带注释的这行很关键

运行就可以了

运行结果

基于.Net Framework进行配置Swagger
qq_38365099的博客
11-06 6163
第一步：首先在WebApi中进行管理NuGet包然后安装下图对应的插件 安装完成后 第二步：修改SwaggerConfig.cs 如 api 版本号，title等相关信息 第三步：创建项目XML注释文档 右键项目→属性→生成→选中下方的 “XML文档文件” 然后保存 第四步：配置启用 在WebApi中的App_Start中的SwaggerConfig.cs中进行配置 c.Inclu...
java：springboot3集成swagger（springdoc-openapi-starter-webmvc-ui）
bsefef的博客
12-12 1271
Swagger 和 OpenAPI 是一对相关的概念，Swagger 是前身，OpenAPI 是其演进和规范化。Springfox和 Springdoc 是一对相关的概念，Springfox是一个将 Swagger 2.x 规范集成到 Spring Boot 项目中的库，提供了用于定义 API 和生成 Swagger UI 的功能。
MVC4+ .Net Framework4.0 +Windows Server 2003
a757956132的专栏
03-01 670
又遇到03服务器，.Net Framework必须将版本到4.0 …………………… 事实证明直接降版本会报好多好多的错，因为项目调用的其他dll不兼容4.0，有人总结的很好《把Asp.net MVC4.0（net framework4.5） 部署到window server 2003上的解决方案》https://www.cnblogs.com/zjypp/p/3614454.ht...
C#中API调用的多种方法
ocean_hhn的博客
07-14 7769
API( Application Programming Interface ),我想大家不会陌生
了解 .NET 9 中的新 Microsoft.AspNetCore.OpenApi 包，并将其与 NSwag 和 Swashbuckle.AspNetCore 进行比较
ChaITSimpleLove的博客
10-26 699
本文介绍了 `.NET 9` 中新推出的 `Microsoft.AspNetCore.OpenApi` 包，该包旨在为 `ASP.NET Core` 应用程序生成 `OpenAPI` 文档。文章对比了 `NSwag` 和 `Swashbuckle.AspNetCore` 两大现有库，探讨了新包的优势和不足，特别是在性能和功能方面。尽管新包在某些方面尚不及成熟库完善，但其对原生 `AoT` 编译的支持和未来的扩展潜力使其成为一个值得考虑的选择。文章还提供了详细的性能测试数据和优化建议。
C# WinForms - 企业ERP管理系统
05-18
☆ 功能如下：☆ 企业ERP管理系统主要由基础管理、采购管理、销售管理、仓库管理、生产管理、客户管理、财务管理、报表统计和系统管理等模块组成； ☆基础管理模块☆ 该模块主要用于设置系统的各种基础分类、各种档案资料、结算账户、物料清单、及库存初始化信息等； ☆采购管理模块☆ 该模块主要用于管理原材料的采购预订、采购入库、采购付款等业务； ☆销售管理模块☆ 该模块主要用于管理产品的销售预订、销售出库、销售收款等业务； ☆仓库管理模块☆ 该模块主要用于对产品和原材料的库存管理，包括领料、退料、报损、库存盘点、查询库存清单等业务； ☆生产管理模块☆ 该模块主要用于对企业车间各种生产活动的管理，包括从生产计划到产成品入库的一系列生产活动； ☆客户管理模块☆ 该模块为企业提供全方位的管理视角；赋予企业更完善的客户交流能力，最大化客户的收益率； ☆财务管理模块☆ 该模块主要用于管理银行的存取款、采购费用、销售费用等日常财务工作； ☆报表管理模块☆ 该模块主要用于统计原材料采购、产品销售、利润收益、库存预警等数据分析报表； ☆系统管理模块☆ 该模块主要用于进行操作员管理、密码维护、权限设置等系统设置业务；
.net web api中Swagger使用教程
最新发布
qq_31210287的博客
07-29 1145
本文介绍了在.NET 8中使用Swagger的教程。主要包含三个核心概念：OpenAPI规范（定义RESTful API的标准）、Swagger工具集（实现和展示OpenAPI的工具）和Swashbuckle（.NET平台的实现）。使用流程包括：创建项目、引入Swashbuckle包、基础配置（生成OpenAPI文档和UI界面）以及配置Token验证（添加安全定义使请求头携带Token）。关键代码展示了如何在Program.cs中配置Swagger服务和UI，并设置Bearer Token认证方式。
全新Swagger3.0教程，OAS3快速配置指南，实现API接口文档自动化！
热门推荐
m0_59562547的博客
07-20 1万+
1、前言 ①在前后端分离开发中，一般需要构建一份API文档来描述所有接口信息，文档工作量巨大，需要包含接口地址、请求参数以及返回值等，且维护不方便，一旦接口发生变化就需要修改文档。 ②Swagger的出现可以帮助开发人员设计、构建、记录是使用RESTFul Web服务，将代码和文档融为一体，可以完美解决上述问题，将开发人员的精力集中到业务中，而不是繁琐的文档。 ③网上很多Swagger教程均基于Swagger2，现均已过时，而本文将带来全新Swagger3.0教程，以最简单的方式实现Swagger3(
.net asp.net 办公自动化系统OA源码
12-28
3. **.NET ASP.NET 技术栈** - **ASP.NET MVC**：用于构建表现层，提供模型-视图-控制器模式，分离业务逻辑和视图展示。 - **Entity Framework**：作为数据访问层的ORM框架，简化数据库操作。 - **LINQ**：语言...
ASP.NET源码——Tsoft办公自动化系统源码.zip
10-10
它在.NET Framework之上运行，提供了一种高效的编程模型，支持多种编程语言，如C#、VB.NET等。在这个名为"ASP.NET源码——Tsoft办公自动化系统源码.zip"的压缩包中，包含的是一个基于ASP.NET开发的Tsoft办公自动化...
ASP.NET+SQL蒋和平_办公自动化管理系统的设计与实现(源代码+论文).rar
11-08
ASP.NET是微软公司开发的一种Web应用程序框架，它构建在.NET Framework之上，提供了高效、安全、可扩展的Web应用开发环境。此压缩包“ASP.NET+SQL蒋和平_办公自动化管理系统的设计与实现(源代码+论文)”包含了一套...
ASP.NET项目开发案例精粹05 办公自动化系统源码
12-13
3. **ADO.NET**：这是.NET Framework中用于数据库访问的技术，通过ADO.NET，开发者可以轻松地与SQL Server或其他数据库进行交互，处理办公自动化系统中的数据存储和检索。 4. **Entity Framework**：作为ADO.NET的...
浅谈ASP.NET框架
weixin_30445169的博客
01-10 850
本篇文章更适合具有一定开发经验，一定功底，且对底层代码有所研究的朋友！！！ 本篇文章稍微偏原理且底层，有一定难度和且比较晦涩，文章粒度稍微粗些，更细粒度的，会在后续的文章中，结合具体的Demo实例分析。感兴趣的朋友，可以先收藏。 一 .NET框架概述 1.作用:提供了基于.NET框架开发的基础平台和模板，为.NET开发的基架; 2.基本构成:可支持语言，CLS，模板框架，基...
The JSON value could not be converted to System.Int64
iTrice的博客
04-21 6037
前端返回的json里面包含了引号 例如 ：{ index:“1” } 在ASP.NET Core 3.0 MVC 之后可以用Newtonsoft.Json来解决。方式如下图：
VS 2019 目标框架没有dotnet core
iTrice的博客
01-18 4122
最近尝试了abp vnext，项目下载后也更新了最新的.net core 5.0，但是项目依旧提示失败。打开项目属性后发现无法选择.net core的项目。几经周折，发现是vs 2019版本过低导致的。 所以更新VS
VS2019 升级到16.6遇到的坑
iTrice的博客
03-24 3212
前天手贱，把电脑的VS2019进行了升级。然后把老的VS2015，2017都卸载了。然后出现了意想不到的结果。。。提示无法加载项目XXXX， 具体的错误，因为已经修复了，也不想在去复现了。 反正就是依赖项看起来有个警告，就算新建的项目也一样，也无法编译。折腾了2天，卸载重装，各种折腾。差点都放弃准备重装系统了。 后来查看系统日志，发现MSbuild也不行了。直接运行MSBuild出现以下错误 $:...
dotnet tool 无法安装的问题
iTrice的博客
06-27 2612
昨天在使用安装ABP CLI的时候遇到安装不了的问题。如下： Failed to install tool package 'Volo.Abp.Cli': Could not find a part of the path 'C:\Users\admin\.dotnet\tools\.store\.stage\0qd2mqpa.m45\Volo.Abp.Cli'. Tool 'Volo.Abp.Cli' failed to install. This failure may have been caused
C# 字符串拼接的性能优化点（Linq.Aggregate和string.Join和人工拼接）
iTrice的博客
08-16 2017
为了把数组通过“，”号拼接起来，以前会用Linq.Aggregate，拼接很简单，但是后来发现运行效率很低，于是就有以下2中种方式： 1、for or foreach 就是比较麻烦，需要手动实现这些过程。但是效率高，接近string.Join，ps：记得用StringBuilder. 2、string.Join 使用简单，效率最高。 public static string J...
ASP.NET Core Web API基础项目配置Swagger指南
3. **Swagger集成在ASP.NET Core Web API中的应用** 在ASP.NET Core Web API项目中集成Swagger主要是为了提供更加友好的API管理和交互体验。集成Swagger通常涉及以下步骤： - 安装Swagger相关的NuGet包，如...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值