ASP.NET Core WebApi使用Swagger生成api说明文档

1.

2.

3.Startup.cs---ConfigureServices

  //注册Swagger生成器，定义一个和多个Swagger 文档
            services.AddSwaggerGen(c =>
            {
                c.SwaggerDoc("v1", new Info
                {
                    Version = "v1",
                    Title = "标题---哈哈哈",
                    Description = "描述---呵呵呵",
                    TermsOfService = "https://www.baidu.com/",
                    Contact = new Contact
                    {
                        Name = "张三",
                        Email = "[email protected]",
                        Url = "https://www.baidu.com/"
                    },
                    License = new License
                    {
                        Name = "许可证名字",
                        Url = "https://www.baidu.com/"
                    }
                });
                // 为 Swagger JSON and UI设置xml文档注释路径
                var basePath = AppContext.BaseDirectory;
                var xmlPath = Path.Combine(basePath, "SwaggerDemo.xml");
                c.IncludeXmlComments(xmlPath);
            });

4.Startup.cs---Configure

          //启用中间件服务生成Swagger作为JSON终结点
            app.UseSwagger();
            //启用中间件服务对swagger-ui，指定Swagger JSON终结点
            app.UseSwaggerUI(c =>
            {
                c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
                //要在应用的根 (http://localhost:<port>/) 处提供 Swagger UI， RoutePrefix 属性设置为空字符串
                c.RoutePrefix = string.Empty;
            });

5.

6.