ASP.NET Core教程-Configuration（配置）-Swagger

更新记录
转载请注明出处：
2022年11月8日 发布。
2022年11月5日 从笔记迁移到博客。

注册服务

在服务容器中注册服务，使用 AddSwaggerGen() 方法。

builder.Services.AddSwaggerGen();

还可以设置额外的配置信息

builder.Services.AddSwaggerGen(options =>
{
    //设置Swagger生成的文档信息
    options.SwaggerDoc("v2", new OpenApiInfo { Title = "WebApp", Version = "v2" });
});

在管线中使用中间件

app.UseSwaggerUI();

还可以配置 Swagger JSON文档文件的 URL 端点。

app.UseSwaggerUI(options => {
        //设置Swagger的文档路径信息
        options.SwaggerEndpoint("/swagger/v2/swagger.json", "WebApp");
    });