首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

安装Swashbuckle.AspNetCore包后,Aspnet核心2.2默认路由更改为"~/index.html“

安装Swashbuckle.AspNetCore包后,Aspnet核心2.2默认路由更改为"~/index.html"。

Swashbuckle.AspNetCore是一个用于生成和展示API文档的开源库,它基于ASP.NET Core框架。安装Swashbuckle.AspNetCore包后,可以通过Swagger UI来展示和测试API接口。

默认情况下,ASP.NET Core 2.2使用的是传统的MVC路由,即使用控制器和动作方法来处理请求。但是安装了Swashbuckle.AspNetCore包后,它会添加一个默认的路由规则,将默认路由更改为"~/index.html"。

这个默认路由的作用是提供Swagger UI的入口,让开发人员可以通过浏览器访问"~/index.html"来查看API文档和测试API接口。

Swashbuckle.AspNetCore的优势在于它能够自动生成API文档,减少了手动编写文档的工作量。它还提供了丰富的功能,如自定义API文档的样式和主题、支持认证和授权、支持API版本控制等。

安装Swashbuckle.AspNetCore包后,可以在Startup.cs文件的ConfigureServices方法中添加以下代码来启用Swagger UI:

代码语言:txt
复制
services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
});

然后,在Configure方法中添加以下代码来启用Swagger UI的中间件:

代码语言:txt
复制
app.UseSwagger();
app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
    c.RoutePrefix = string.Empty; // 将默认路由更改为"~/index.html"
});

这样,当你运行应用程序并访问"~/index.html"时,就可以看到自动生成的API文档和测试界面了。

推荐的腾讯云相关产品:腾讯云API网关。腾讯云API网关是一种全托管的API管理服务,可以帮助开发者更好地管理和发布API接口。它提供了丰富的功能,如流量控制、访问控制、请求转发、监控报警等,可以帮助开发者更好地管理和保护API接口。

腾讯云API网关产品介绍链接地址:https://cloud.tencent.com/product/apigateway

页面内容是否对你有帮助?
有帮助
没帮助

相关·内容

ASP.NET Core 实战:构建带有版本控制的 API 接口

你可以直接右键选中 API 项目选择管理 Nuget 程序进行加载引用,也可以通过程序包管理控制台进行添加引用,这里注意,使用程序包管理控制台时,你需要将默认的项目修改成 API(Grapefruit.WebApi...当引用添加完成,我们就可以在项目中配置 Swagger 了。 ? Install-Package Swashbuckle.AspNetCore ?   ...); });   当我们添加好路由规则定义,我们在 Area 的 Controllers 文件夹下添加一个 WebAPI Controller。...这里需要注意下安装的版本问题,因为 Grapefruit.VuCore 这个框架距离现在搭建也有几个月的时间了,在这个月初的时候 .NET Core 2.2 也已经发布了,如果你和我一样还是采用的 .NET...三、总结   本章使用了 Microsoft.AspNetCore.Mvc.Versioning 这一组件来实现我们对于 API 版本控制的功能实现,可能你会有疑问,我们直接在路由中写明版本信息不是简单吗

1.2K30

在asp.net core2.1中添加中间件以扩展Swashbuckle.AspNetCore3.0支持简单的文档访问权限控制

直接从您的路由,控制器和模型生成漂亮的 API 文档,包括用于探索和测试操作的 UI。...项目主页:https://github.com/domaindrivendev/Swashbuckle.AspNetCore 划重点,使用多看看 Readme,然后看下项目官方示例,遇到问题找找 issues...asp.net core 中,自然就需要用到的是中间件了 步骤如下,在 UseSwagger 之前使用自定义的中间件 拦截所有 swagger 相关请求,判断是否授权登录 若未登录则跳转到授权登录页,登录即可访问...添加退出按钮 自定义 index.html 文档 默认 index.html if (configObject.customAuth) { var logOutEle = document.createElement...,login.html 注意:需要将其改为内嵌资源(属性->生成操作->嵌入的资源) 点此查看 index.html 点此查看 login.html 完整 Demo 下载 Github 预览 博客园下载

1.1K10

微软发布ASP.NET Core 2.2,先睹为快。

此页面还提供了新的Windows Server托管,运行时安装程序和二进制存档,用于更新服务器。...当微软宣布推出针对2.2路线图的ASP.NET核心健康检查时,BeatPulse团队移植了所有现有的活动和功能,以便在存储库AspNetCore.Diagnostics.HealthChecks中使用新的...如何将项目迁移到ASP.NET Core 2.2 要将ASP.NET Core项目从2.1迁移到2.2,请打开项目的.csproj文件并将TargetFramework元素的值更改为netcoreapp2.2...Azure App Service中的可用性 .NET Core 2.2 SDK,运行时和更新的ASP.NET核心IIS模块正在部署到全球的Azure App Service区域。...某些区域可能会在更新的ASP.NET核心IIS模块(ANCM)之前收到更新的运行时,对于面向ASP.NET Core 2.2的项目,默认情况下这是必需的。这也是新的进程内托管功能的要求。

3.4K40

如何在 asp.net core 的中间件中返回具体的页面

但是在网上搜了搜也没有专门介绍这块的文档或文章,所以本篇文章就来说明如何在中间件中返回页面,如果你有类似的需求,希望可以对你有所帮助 Step by Step 最终实现的功能其实很简单,当用户跳转到某个指定的地址,...的代码,了解它是如何实现的这一功能,从而给我们的功能实现提供一个思路 在 asp.net core 中使用 Swashbuckle.AspNetCore 时,我们通常需要在 Startup 类中针对组件做如下的配置..."index.html" : $"{path.Split('/').Last()}/index.html"; RespondWithRedirect(httpContext.Response...await _staticFileMiddleware.Invoke(httpContext); } 这里需要注意,因为类似于这种功能,我们可能会打包成独立的 nuget ,然后通过 nuget...当完成了页面的呈现,因为一般我们会创建一个单独的类库来实现这些功能,在页面中,可能会包含前后端的数据交互,由于我们在宿主的 API 项目中已经完成了对于路由规则的设定,所以这里只需要在类库中通过 nuget

2K20

iis7.0上发布mvc4.0网站

步骤如下: 1.右击需要发布的项目,在弹出的菜单中选择“发布...”选项 2.在“发布web”对话框中进行设置,配置文件名称默认为“配置文件1”可以修改为需要的名字,以便识别,也可以不改。...安装 Microsoft .net FrameWork 4.0安装(网站开发时候使用的就是.net framework4.0框架); 2. 安装ASP.NET MVC 4.0 ; 3....\v4.0.30319\aspnet_regiis.exe -i 来运行注册iis。...2.由于mvc4.0在创建项目默认在项目下的App_Start文件夹中的文件“RouteConfig.cs”里自动配置了“默认路由”为HomeController控制器下的Index方法(ActionResult...),所以不需要在站点默认文档里配置默认文档名字,该站点会自动根据mvc的路由机制找到默认需要显示的视图文件。

1.2K100

ASP.NET Core 各版本特性简单整理

/announcing-asp-net-core-2-0/ Docs: ASP.NET Core 2.0 中的新增功能 新增功能: Razor Pages ASP.NET Core 元(注:即Microsoft.AspNetCore.All...,我喜欢称作全家桶,作用就是一把梭给你全部引用了相关的,不用你发现没有的时候自己去找,方便是方便,就是把一堆没用到的也给引用了,项目加载速度也会受到影响) .NET Standard 2.0 SPA...2-2-available-today/ Docs: ASP.NET Core 2.2 的新增功能 新增功能: 端点路由(Endpoint Routing) 健康检查(HealthCheck) HTTP.../2 IIS 进程内承载 SignalR Java 客户端 CORS 改进 响应压缩(ASP.NET Core 2.2 可以使用 Brotli 压缩格式来压缩响应。)...切换到 Newtonsoft.Json 需要自行安装依赖 性能改进 ASP.NET Core 3.0 包含了许多改进,可减少内存使用量并提高吞吐量: 降低了使用内置的依赖项注入容器来实现作用域服务时的内存使用量

3.3K20

asp.net core使用Swashbuckle.AspNetCore(swagger)生成接口文档

asp.net core中使用Swashbuckle.AspNetCore生成接口文档 Swashbuckle.AspNetCore:swagger的asp.net core实现 项目地址:https...暂时见demo) 使用JWT的简单接口验证(暂时见demo) 构建一个webapi项目并使用swagger 新建asp.net core webapi项目 dotnet new webapi 安装...nugetSwashbuckle.AspNetCore,本文使用版本1.1.0,.net core版本2.0+ 编辑解决方案添加(或者在vs中项目属性->生成->勾选生成xml文档文件)如下配置片段...除了swagger发现还有好多东西要写,但是一篇貌似又太多了,so..请听下周分解吧 这篇文章是先有demo,有需要的可以至文末下载demo查看,大概还有如下几个可以写的地方 JWT的使用 自定义路由特性标记的扩展...配置默认路径

2K10

ASP.NET Core 2.2 正式版发布

此页面还提供了新的 Windows Server hosting,运行时安装程序和二进制存档,用于更新服务器。...将项目迁移到ASP.NET Core 2.2 要将ASP.NET Core项目从2.1迁移到2.2,请打开项目的.csproj文件,并将TargetFramework结点的值更改为netcoreapp2.2...目前预计2.2将是2.x生命周期中的最后一次non-servicing版本,因此不使用LTS版本的客户将需要在2019年下半年发布的3个月内迁移到3.0 GA 为了保持支持。...某些区域可能会在更新的ASP.NET Core IIS模块(ANCM)之前收到更新的运行时,对于面向ASP.NET Core 2.2的项目,默认情况下这是必需的。 这也是新的进程内托管功能的要求。...给予反馈 与往常一样,请通过https://github.com/aspnet/AspNetCore issues向我们提供反馈。 我们期待您的回音!

2K20

使用vue-cli搭建spa项目

使用vue-cli构建项目 2.1 使用脚手架创建项目骨架 2.2 到新建项目目录,安装需要的模块 2.3 如何修改端口号 2.4 添加element-ui模块 2.5 package.json详解 3...开发示例 7.1 做一个自定义组件Welcome 7.2 增加“用户管理”和“关于我们”组件 7.3 嵌套路由 1. vue-cli安装 1.1 安装前提 在安装vue-cli前需要先确定nodejs环境安装好...2.2 到新建项目目录,安装需要的模块      此步骤类似于maven通过pom文件安装依赖。 命令: npm install 需要些流量,请使用速度较好的网络。...prod.env.js 配置生产环境 index.js 这个文件进行配置代理服务器,例如:端口号的修改 node_modules 存放npm install时根据package.json配置生成的npm安装的文件夹...HelloWorld,修改为了Welcome组件。

72510

或许是你应该了解的一些 ASP.NET Core Web API 使用小技巧

1、使用小写路由   在我之前的一篇文章中(构建可读性更高的 ASP.NET Core 路由)有提到过,因为 .NET 默认采用 Pascal 的类命名方式,如果采用默认生成的路由,最终构建出的路由地址会存在大小写混在一起的情况...,虽然在 .NET Core 中大小写的路由地址最终都会对于到正确的资源上,但是为了更好的符合前端的规范,所以这里我们首先按照之前的文章中所列出的方法去修改默认生成的路由地址格式。   ...因为这里我们最终想要实现的是符合 Restful 风格的 API 接口,所以这里我们首先需要将默认生成的 URL 地址改为全小写模式。...同时,因为我需要将 API 的版本信息添加到生成的 URL 地址中,所以这里我们需要修改特性路由的模板,将我们的版本以占位符的形式添加到生成的路由 URL 地址中,修改完成的代码及实现的效果如下所示。...在 ASP.NET Core 2.2 及以后更新的 ASP.NET Core 版本中,我们可以通过 Nuget 去添加 Microsoft.AspNetCore.Mvc.Api.Analyze 这个

1.2K20

或许是你应该了解的一些 ASP.NET Core Web API 使用小技巧

1、使用小写路由   在我之前的一篇文章中(构建可读性更高的 ASP.NET Core 路由)有提到过,因为 .NET 默认采用 Pascal 的类命名方式,如果采用默认生成的路由,最终构建出的路由地址会存在大小写混在一起的情况...,虽然在 .NET Core 中大小写的路由地址最终都会对于到正确的资源上,但是为了更好的符合前端的规范,所以这里我们首先按照之前的文章中所列出的方法去修改默认生成的路由地址格式。   ...因为这里我们最终想要实现的是符合 Restful 风格的 API 接口,所以这里我们首先需要将默认生成的 URL 地址改为全小写模式。...同时,因为我需要将 API 的版本信息添加到生成的 URL 地址中,所以这里我们需要修改特性路由的模板,将我们的版本以占位符的形式添加到生成的路由 URL 地址中,修改完成的代码及实现的效果如下所示。...在 ASP.NET Core 2.2 及以后更新的 ASP.NET Core 版本中,我们可以通过 Nuget 去添加 Microsoft.AspNetCore.Mvc.Api.Analyze 这个

1.4K40
领券