安装:WebApiTestClient:
1、修改Api.cshtml文件
通过上述步骤,就能将组件WebAPITestClient引入进来。下面我们只需要做一件事:打开文件 (根据 Areas\HelpPage\Views\Help) Api.cshtml 并添加以下内容:
- @Html.DisplayForModel("TestClientDialogs")
- @Html.DisplayForModel("TestClientReferences")
添加后Api.cshtml文件的代码如下
@Html.DisplayForModel("TestClientDialogs") @section Scripts{ <link href="~/Areas/HelpPage/HelpPage.css" rel="stylesheet" /> @Html.DisplayForModel("TestClientReferences") }
2、配置读取注释的xml路径
其实,通过上面的步骤,我们的项目已经可以跑起来了,也可以调用接口测试。但是,还不能读取 /// <summary> 注释里面的东西。需要做如下配置才行。
(1)配置生成xml的路径。我们在项目上面点右键→属性→生成标签页配置xml的路径
(2)在xml的读取路径:在下图的HelpPageConfig.cs里面配置一句话,指定xml的读取路径。
config.SetDocumentationProvider(new XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/App_Data/WebApiTestClient.XML")));
3、C# CS1591 缺少对公共可见类型或成员的 XML 注释 问题解决
这是由于代码编写不规范造成的,为了消除这些警告,可能的方法如下:
项目->属性-生成,禁止限制警告,输入1591,警告编号,这是针对整个项目级别的
代码中加入一下代码,用于禁止警告,注意,这个只是针对文件级别的
#pragma warning disable 1591
如果想要恢复显示警告提示,则使用以下语句
#pragma warning restore 1591
4、如果调试窗口不能正常居中,我们可看到有:解决 Uncaught TypeError: elem.getClientRects is not a function 警告信息
文件下载地址:https://www.51qianduan.com/datum/cate/30