首页
学习
活动
专区
圈层
工具
发布

ASP.NET Web API RC版本新特性:Web API的帮助文档制作

InfoQ上有一篇文章是 使用IAPIExplorer列举ASP.NET Web API,文章针对的版本是ASP.NET Web API Beta版本写,IAPIExplorer已经包含在RC版本里了,...而且发现ASP.NET Web API的HttpConfiguration 的RC版本比Beta版本多了一个属性: public DefaultServices Services { get; internal...使用该API可以完成的工作有: 产生文档 创建机器可读的元数据 创建一个测试客户端 微软员工Yao发表了两篇文章(ASP.NET Web API: Introducing IApiExplorer/ApiExplorer...和ASP.NET Web API: Generating a Web API help page using ApiExplorer)分别用于展示如何使用API打印Web API列表以及如何创建帮助文档...所以我们创建帮助文档主要就是参照这篇文章就可以了ASP.NET Web API: Generating a Web API help page using ApiExplorer;作者在文章里面已经实现了一个

1.3K100
  • 您找到你想要的搜索结果了吗?
    是的
    没有找到

    【壹刊】Azure AD 保护的 ASP.NET Core Web API (下)

    上一篇结尾我们成功的拿到了 access_token,并且通过 access_token 验证获取到调用Api资源的结果。...是只谁颁发的这个令牌,很显眼就我们azure认证的一个域在加上我们创建的这个租户 3,iat:令牌颁发时间 4,exp:令牌过期时间,与上面的颁发时间相差5分钟 5,appid:客户端Id,就是在Azure...1)为WebApi应用创建客户端密码 选择过期时间,点击 ”添加“ 复制这个密码的值,提示以下,切换到其他页面后,就无法再进行复制了,所有提前先复制好。...其实不难看出,这个账号就是我们当前azure portal的登录账号,也是当前订阅的管理员账号,而且我们在创建MyCommany这个租户的时候也是使用的当前登录的账号,所有当前登录的账号也就自然而然的成为当前租户下应用注册的资源所有者...到此 关于ASP.NET Core Web Api 集成 Azure AD 的授权认证暂时告一段落。

    3K10

    通过ASP.NET Web API + JQuery创建一个简单的Web应用

    看了dudu的《HttpClient + ASP.NET Web API, WCF之外的另一个选择》一文,想起多很久之前体现ASP.NET Web API而创建的一个Demo。...这是一个只涉及到简单CRUD操作的Web应用,业务逻辑以Web API的形式定义并以服务的形式发布出来,前台通过jQuery处理用户交互并调用后台服务。...[源代码从这里下载] 目录 一、一个简单的基于CRUD 二、通过ASP.NET Web API提供服务 三、通过JQuery消费服务 一、一个简单的基于CRUD...二、通过ASP.NET Web API提供服务 我们来简单介绍作为Web API形式发布的联系人管理服务的定义,先来看看用于表示联系人的Contact类型的定义。...三、通过JQuery消费服务 我们通过ASP.NET MVC来构建Web应用,默认的HomeController定义如下,默认的Index操作仅仅是将默认的View呈现出来而已。

    1.2K100

    Asp.Net Core API 需要认证时发生重定向的解决方法

    Asp.Net Core API 需要认证时发生重定向的解决方法 使用 .Net Core 开发 API 时, 有些 API 是需要认证, 添加了 [Authorize] 标记, 代码如下所示: [Route...对于浏览器来说, 重定向是正确的, 而 Ajax 请求则会自动继续请求重定向之后的地址, 因此必须解决掉返回重定向的问题。...既然是通过添加 Identity 认证造成, 肯定要从 Identity 来找问题, 经过一番搜索, 终于在 CookieAuthenticationEvents 中找到了原因, 代码中有关于是否是 Ajax...QueryString 或者 Header 中包含 X-Requested-With 并且值为 XMLHttpRequest 的话, 则会被判断为 AjaxRequest , 将不会返回重定向结果, 问题原因找到了...API 就不会有重定向结果返回了。

    2.2K51

    创建API服务最小只要4行代码!!!尝新体验ASP.NET Core 6预览版本中的最小Web API(minimal APIS)新特性

    尝新体验ASP.NET Core 6预览版本中的最小Web API(minimal APIS)新特性》 概述 .NET开发者们大家好,我是Rector。...几天前(美国时间2021年8月10日),微软官方发布了.NET 6的第7个预览版,其中包含了很多新的特性和功能,比如: 优化最小Web API(minimal APIS)模板 为生成常用HTTP响应添加了...本文我们主要来体验最小Web API的功能和特性。最小Web API的目的主要是帮助C#(或者F#)后端开发者快速创建微服务项目或者HTTP API服务。...与之前的ASP.NET Core Web API相比,最小Web API在启动模板和框架结构上都有些不同。...与以往的ASP.NET Core应用程序相同,在最小API项目中,你仍然可以使用像Swagger这样的接口文档组件。

    6.9K30

    如何测量并报告ASP.NET Core Web API请求的响应时间

    如何测量并报告ASP.NET Core Web API请求的响应时间 介绍 大家都知道性能是API的流行语。而相应时间则是API性能的一个重要并且可测量的参数。...我们需要在执行方法之前和之后执行响应时间的计算代码。如果您使用过早期版本的Asp.net Web API,那么您将熟悉Filter的概念。过滤器允许您在请求处理管道中的特定阶段之前或之后运行代码。...因此,它实际上无法检测在其他Asp.net管道中花费的时间。 ? 第三次尝试 我们将使用Asp.net Core中间件来计算API的响应时间 所以,什么是中间件呢?...我们希望在请求进入ASP.NET Core管道后添加代码以启动计时器,并在管道处理响应后停止计时器。请求管道开始时的自定义中间件似乎是访问请求最早访问并在管道中执行最后一步之前进行访问的最佳方法。...总结 在本文中,我们了解了如何利用ASP.NET中间件来管理跨领域问题,例如测量API的响应时间。使用中间件还有其他各种有用的用例,可以帮助重用代码并提高应用程序的可维护性。

    2.5K10

    创建新Docker容器时出现“The container name “xxx“ is already in use by container xxxxxxxxxxx...”问题的解决办法

    创建新Docker容器时出现“The container name “/xxx” is already in use by container xxxxxxxxxxx…”问题的解决办法 详细错误提示:...tomcat 8.5.35 78b258e36eed 2 weeks ago 463 MB docker.io/tomcat latest 6759d91a032b 3 weeks ago 463 MB 创建新的容器...上面创建新容器出现了错误,提示:容器名被占用,须移除或重命名后才能使用这个容器名。...e3274a72e8d6 e3274a72e8d6 再看,容器已经移除: docker ps -a CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 然后再创建新容器...tomcat8080 -d -p 8080:8080 tomcat af52e9ac72c0393b5468cccf235ad70a7bf6a6b4ed30122b345b3758875d8911 新容器创建成功

    3.9K10

    BrowserDetector:为 ASP.NET Core Web API 提供浏览器检测功能的利器

    在 .NET Framework 4.7 中那样,通过 HttpContext.Request 的 Browser 属性轻松获取发起 HTTP 请求的浏览器信息,ASP.NET Core 并未直接提供这一功能...,现在有了 BrowserDetector 这个强大的 NuGet 包,你可以在 ASP.NET Core 应用中轻松实现浏览器、设备类型以及操作系统的检测。...IBrowserDetector.Name 返回的名称值具有特定含义,以下是常见名称的解释: • Firefox:Firefox 浏览器。...经过基准测试,在 Safari 和 Chrome 桌面用户代理上的测试结果显示,检测结果的返回时间大约在 1 微秒 左右。堆内存分配会根据输入的不同而有所变化。...对性能的影响微乎其微,你完全可以放心使用它来为你的 ASP.NET Core Web API 应用增添浏览器检测功能。

    54000

    Microsoft Graph 的 .NET 6 之旅

    步骤 6 — 为 ASP.NET Core 创建新的 Web 服务器项目 使用等效设置,为 ASP.NET Core 创建一个新项目,与当前 ASP.NET 框架项目并行。...新 ASP.NET Core 项目默认使用 Kestrel。它非常好,是大多数.NET团队投资的地方。这是他们的跨平台Web服务器。...一旦初始部署在小规模内成功并经过审查,请按照现有的安全部署实践逐步实施,计划使用逐步推出来启用新位。重要的是要遵循逐步实施,这样您就可以及时检测和缓解可能随着数量和规模的增加而出现的问题。...删除用于 ASP.NET 的 Web 服务器项目,并将所有项目库显式移动到 .NET Core 而不是 .NET Standard,以便您可以开始使用较新的 API 和语言功能,使开发人员能够编写更好的代码...当我们从 ASP.NET 转移到 ASP.NET Core时,许多这些假设都被违反了,导致许多问题和边缘情况。

    1.8K10

    【重榜?】.NET 6 Preview 1 开箱上手!带你尝试新版本更新!

    回顾一下跨平台 UI 应用,主要提到 Xamarin 和 Blazor,而 .NET6 会出现一个新的跨平台 APP UI 框架,叫 MAUI,.NET MAUI是Xamarin.Forms 的演进,这个在...一组新的数学 API,提高处理数学的性能和根据硬件提升性能; 改善单文件体积 发布的二进制文件打包形式可以提升体积大小;但是之前一直说的 AOT 极端优化,还没有出现; Crossgen2...编写的,并且可以自举;crossgen2 仅适用于CoreCLR; ASP.NET Core ASP.NET Core 的路线图独立于 .NET,大家可以参考:https://themesof.net...可空引用类型注释 这个是非常好的规范约束,现在 ASP.NET Core 中的各个部分都加上了这些注释,可以更加容易地提升项目的编译安全性。...选择使用可为空的注释的项目可能会从ASP.NET Core API中看到新的生成时警告。 另外 EFCore 也进行了一些更新,没啥影响,这里就不提了。

    4.6K20

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

    在本篇文章中,我将列举一些我在使用 ASP.NET Core Web API 构建接口服务时使用到的一些小技巧,因才疏学浅,可能会存在不对的地方,欢迎指出。   ...ASP.NET Core Web API 中如何去使用,不会做过多的详细介绍。...HTTP 状态码为 200 或是 400,当状态码为 200 时,代表数据获取成功,接口可以正常返回数据,当状态码为 400 时,则代表接口访问出现问题,此时则返回错误信息对象。   ...在 ASP.NET Core Web API 中,我们可以通过在 Action 上添加 ProducesResponseType 特性来定义接口的返回状态码。...三、总结    在本篇文章中,主要介绍了一些我在使用 ASP.NET Core Web API 的过程中使用到的一些小技巧,以及在以前踩过坑后的一些解决方案,如果对你能有一点的帮助的话,不胜荣幸。

    1.6K20

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

    在本篇文章中,我将列举一些我在使用 ASP.NET Core Web API 构建接口服务时使用到的一些小技巧,因才疏学浅,可能会存在不对的地方,欢迎指出。   ...ASP.NET Core Web API 中如何去使用,不会做过多的详细介绍。...HTTP 状态码为 200 或是 400,当状态码为 200 时,代表数据获取成功,接口可以正常返回数据,当状态码为 400 时,则代表接口访问出现问题,此时则返回错误信息对象。   ...在 ASP.NET Core Web API 中,我们可以通过在 Action 上添加 ProducesResponseType 特性来定义接口的返回状态码。...三、总结    在本篇文章中,主要介绍了一些我在使用 ASP.NET Core Web API 的过程中使用到的一些小技巧,以及在以前踩过坑后的一些解决方案,如果对你能有一点的帮助的话,不胜荣幸。

    1.8K40

    【壹刊】Azure AD(二)调用受Microsoft 标识平台保护的 ASP.NET Core Web API (上)

    (三)添加受保护资源 1,VS 创建 “Asp.Net Core WebApi” 项目,并且添加 “OrderController” 控制器,并且新增相应的方法,此步骤暂时省略,详细代码我整理完成后,会添加到...  5.2,选中刚刚创建的 “MyCompany” 的目录,继续在Portal首页左侧选择 “Azure Active Directory”,选中 “应用注册” ,点击 “新注册”  5.3...,填写应用注册的一些基本信息     (1)添加受保护的Api资源的名称,也就是我们在VS中创建的.Net Core 的 WebApi 项目,我这里暂时命名为 “WebApi”,     (2)选择支持的账户类型...,我这里选择的是一个多租户的类型     (3)平台配置,选择 Web API,这里的平台配置怎么理解:就好在Web项目中是在成功验证用户身份后,会携带令牌,我们作为目标接受的URL,称其为 ”回调地址...Instance)“   (1)Domain,TenantId (Domain 参数可以在创建目录时,先行复制好) (2)ClientId:选择刚刚注册好的应用程序,进入应用程序页面后,找到对象Id

    2.6K40

    .NET 6.0 中自定义接口路由

    前言 在本文中,我们将讨论ASP.NET Core中的新路由。我们将了解什么是接口(endpoints)路由,它是如何工作的,它在哪里使用,以及如何创建自己的路由。...ASP.NET Core可以映射到以下端点: Controllers (例如, MVC or web APIs) Razor Pages SignalR (and Blazor Server) gRPC...只有MVC和Web API端点使用更复杂的模式。Razor页面的路由定义基于实际页面的文件夹和文件结构。 在ASP.NET Core 2.2中引入端点之前,路由只是运用在MVC和Web API中。...关于早期.NET 6.0版本的说明 在.NET 6.0之前,该映射只能在Startup.cs文件中的UseEndpoints方法中,而使用.NET 6.0和新的Minimal API方法,可以在Program.cs...但是,端点路由是一种更灵活的输出方式,它应该会在ASP.NET Core 3.0以后的所有版本中进行使用。

    75320
    领券