【问题标题】:WebApi2 Help Page stops generating documentation after extending ApiController扩展 ApiController 后 WebApi2 帮助页面停止生成文档
【发布时间】:2014-01-24 17:20:49
【问题描述】:

我已扩展 ApiController 以包含一些常见的属性/方法,并且此扩展控制器保存在单独的类库/程序集中。

public class ExtendedApiController : ApiController
{
    // shared properties...
}

在我的 Api 项目中,所有控制器都继承自这个扩展控制器。

public class HomeApiController : ExtendedApiController
{
    // actions...
}

很简单...

但是,扩展基类现在可以防止帮助页面生成器实际从这些控制器生成文档。如果我将控制器切换回直接从 ApiController 继承,它们在文档中可见。

有没有办法允许/更改生成器查找的程序集名称?我有一个偷偷摸摸的怀疑,它正在将基类直接与“ApiController”进行比较,因此跳过了我的所有内容。

【问题讨论】:

  • 我认为还有其他事情发生,可能是扩展控制器中的文档生成器没有得到的东西,因为我在我的 web api 中使用了类似的扩展控制器,生成的没有问题文档。
  • @Stephen 你的假设是正确的。下面回答...

标签: c# .net asp.net-mvc asp.net-web-api-helppages


【解决方案1】:

好吧,事实证明我的基类在不同的程序集中是问题的一部分。真正的问题是这些项目引用了不同版本的 WebApi2 库。不幸的是,冲突的包版本只是被列为警告,而不是错误,所以我错过了。解决方案中所有项目中所有 NuGet 包的更新修复了该问题。

【讨论】:

  • 编译时带有“警告为错误”,所以下次不要忽略它们。警告您是有原因的;)
猜你喜欢
  • 1970-01-01
  • 1970-01-01
  • 2013-07-30
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 2016-09-24
相关资源
最近更新 更多