ASP.NET Core 2.2 基础知识(十五) Swagger

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);            //注册 Swagger
            services.AddSwaggerGen(sg =>
            {
                sg.SwaggerDoc("refuge", new Swashbuckle.AspNetCore.Swagger.Info
                {
                    Title = "我的第一个 Swagger",
                    Version = "版本1"
                });
            });
        }

        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {            //启用 Swagger            app.UseSwagger();
            app.UseSwaggerUI(s =>
            {
                s.SwaggerEndpoint("/swagger/refuge/swagger.json", "My API 1.0.1");//注意,中间那段的名字 (refuge) 要和 上面 SwaggerDoc 方法定义的 名字 (refuge)一样
                s.RoutePrefix = string.Empty; //默认值是 "swagger" ,需要这样请求:https://localhost:44384/swagger            });

　　　　　　　......
        }

{  "$schema": "http://json.schemastore.org/launchsettings.json",  "iisSettings": {    "windowsAuthentication": false, 
    "anonymousAuthentication": true, 
    "iisExpress": {      "applicationUrl": "http://localhost:56872",      "sslPort": 44384
    }
  },  "profiles": {    "IIS Express": {      "commandName": "IISExpress",      "launchBrowser": true,      //"launchUrl": "api/values",
      "launchUrl": "",      "environmentVariables": {        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },    "SwashbuckleDemo2": {      "commandName": "Project",      "launchBrowser": true,      "launchUrl": "api/values",      "applicationUrl": "https://localhost:5001;http://localhost:5000",      "environmentVariables": {        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);            //注册 Swagger
            services.AddSwaggerGen(sg =>
            {
                sg.SwaggerDoc("refuge", new Swashbuckle.AspNetCore.Swagger.Info
                {
                    Title = "我的第一个 Swagger",
                    Version = "版本1"
                });                var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
                var xmlPath = Path.Combine(AppContext.baseDirectory, xmlFile);
                sg.IncludeXmlComments(xmlPath);
            });
        }

    /// 

    /// 人    /// 
    public class Person
    {        /// 

        /// 编号        /// 
        public int Id { get; set; }        /// 

        /// 姓名        /// 
        [Required(ErrorMessage = "姓名不能为空")]        public string Name { get; set; }        /// 

        /// 年龄        /// 
        public int Age { get; set; }
    }

-----------------------------------------------------------------------------------

下面是回复网友的评论:

        /// 

        /// 测试入参是实体,返回值也是实体        /// 
        /// 人
        ///         [HttpPost]
        [ProducesResponseType(typeof(Person), 250)]//返个250给前端
        public Person GetPerson([FromBody]Person person)
        {            return person;
        }

原文出处： https://www.cnblogs.com/refuge/p/10235522.html