Swagger擴展版本控制

1、在程序裏面建立一個ApiVersions.cs文件，用來設置版本

    public enum ApiVersions
    {
        /// <summary>
        /// 版本一
        /// </summary>
        V1,
        /// <summary>
        /// 版本二
        /// </summary>
        V2,
        /// <summary>
        /// 版本三
        /// </summary>
        V3
    }

　　

2、在Program.cs文件裏面修改相應的內容
將AddSwaggerGen修改爲以下內容

builder.Services.AddSwaggerGen(option =>
{
    //要啓用swagger版本控制要在app控制器或者方法上添加特性        
    [ApiExplorerSettings(GropuName="版本號")]
    typeof(ApiVersions).GetEnumNames().ToList().ForEach(version =>
    {
        option.SwaggerDoc(version, new OpenApiInfo()
        {
            Title = $"{version}:Api文檔",
            Version = version,
            Description = $"通用版本的CoreApi版本{version}"
        });
     });
});

　　

對app.UseSwaggerUI修改成以下內容

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI(option =>
    {
        foreach(string version in typeof(ApiVersions).GetEnumNames())
        {
            option.SwaggerEndpoint($"/swagger/{version}/swagger.json", $"API版本：{version}");
        }
    });
}        

　　

3、在控制器文件裏面添加版本控制

[ApiExplorerSettings(IgnoreApi = false, GroupName = nameof(ApiVersions.V1))]
public class CompanyController : ControllerBase
{

}