Asp.net Core WebApi使用Swagger中间件

原创

于 2021-08-28 01:37:56 发布 · 553 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#asp.net

本文介绍了如何在Asp.net Core WebApi中配置Swagger，包括添加Swashbuckle.AspNetCore Nuget包，注入Swagger服务，添加中间件，以及配置启动程序。重点讲述了如何配置接口显示注释信息，如生成XML文档并注入注释文件，使得Swagger页面能展示接口和参数的详细注释。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在开发Asp.net Core WebApi应用程序时，为了方便调试在创建.Net5项目的时候如果勾选了OpenApi将会自动添加好Swagger，如果没有则需要手动进行配置。

1、首先需要添加Nuget包，选择Swashbuckle.AspNetCore

Swashbuckle.AspNetCore包含了Swashbuckle.AspNetCore.Swagger、Swashbuckle.AspNetCore.SwaggerGen与Swashbuckle.AspNetCore.SwaggerUI

2、注入Swagger服务

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllers();
            services.AddSwaggerGen(setup=> {
                setup.SwaggerDoc("v1",new OpenApiInfo() { Title="房间管理系统",Version="v1"});
            });
        }

3、添加中间件

        public void Configure(IApplicationBuilder app

最低0.47元/天解锁文章

200万优质内容无限畅学