NuGet给项目安装包文件Swashbuckle.AspNetCore
- 在Starup中注入服务和注册中间件
-
- 配置以上条件后运行项目然后在地址栏输入https://localhost:44381/swagger/index.html
得到以下运行效果,看到以下图片不是很满意,跟博客大佬的不是相同,没有接口注释
4. 启用xml
在修改
//注册swagger服务
services.AddSwaggerGen(s =>
{
s.SwaggerDoc("v1", new OpenApiInfo { Title = "XC API", Version = "v1" });
// 获取xml文件名
var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
// 获取xml文件路径
var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
// 添加控制器层注释,true表示显示控制器注释
s.IncludeXmlComments(xmlPath, true);
});
创建拓展方法并且注册使用