在 .NET Core 2.2 中使用 NSwag
🏷️ NSwag
参考 Get started with NSwag and ASP.NET Core 使用 NSwag 时,发现在 .NET Core 2.2.0、 NSwag.AspNetCore 12.0.5 中 services.AddSwagger()
和 app.UseSwaggerUi3WithApiExplorer()
方法已经被弃用了,需要改用对应的 AddSwaggerDocument()
、UseSwagger()
和 UseSwaggerUi3()
方法。
安装 NSwag.AspNetCore NuGet 包
batch
Install-Package NSwag.AspNetCore
1
Startup.cs
csharp
using NSwag.AspNetCore;
1
在 Startup.ConfigureServices
中注册 Swagger Document 服务。
csharp
// Register the Swagger services
services.AddSwaggerDocument();
1
2
2
在 Startup.Configure
启用 Swagger UI。
csharp
// Register the Swagger generator and the Swagger UI middlewares
app.UseSwagger().UseSwaggerUi3();
1
2
2
默认开启了属性首字母小写。
启动后打开 http://localhost:5000/swagger/ 访问 Swagger UI 页面。