.NET 5.0 WebAPI + Swagger 部署到IIS
一、使用 ASP.NET Core 创建 Web API
选择ASP.NET Core 5.0,默认勾选Enable OpenAPI support,项目模板会创建一个支持Swagger的API。取消勾选为HTTPS配置,因为HTTPS需要SSL证书。
创建后的WebAPI项目结构如下图所示:
Visual Studio 将启动:
- IIS Express Web 服务器。
- 默认浏览器,并导航到 https://localhost:/swagger/index.html,其中
是随机选择的端口号。
安装Microsoft.Extensions.PlatformAbstractions包,为每个方法和方法的参数添加注释
修改Startup.cs中的 ConfigureServices方法:
public void ConfigureServices(IServiceCollection services)
{
services.AddControllers();
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new OpenApiInfo {
Title = "TestWebAPI", Version = "v1" });
// 获取xml文件名
var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
// 获取xml文件路径
var xmlPath = Path.Combine(