因此, 现在支持查询字符串参数和header。默认查询字符串参数名称是 api-version, 因此您可以将构造函数留空, 但如果需要其他名称, 则需要提供。您还可以对查询字符串参数和标头使用有不同的名称。请记住, 我们还将 ReportApiVersions 设置为 true, 该值返回响应标头中的版本信息。见下图。
现在, 让我们来看看另外几个选项。
MapToApiVersion参数的用法：
MapToApiVersion 属性允许将单个 API 操作映射到任何版本。换言之, 一个支持多个版本的单控制器。控制器可能只有版本3支持的 API 操作方法。在这种情况下, 您可以使用 MapToApiVersion。看看下面的代码。
上面代码的意思是：public string Get()该方法只有在版本1.0中支持，public string Getv3()方法只有在版本3.0中支持。
有图有真像，很灵活，我很喜欢。
Deprecated参数的用法：
当支持多个 API 版本时, 某些版本最终会随着时间的推移而被弃用。要标记一个或多个 api 版本已被废弃, 只需用Deprecated修饰您的控制器。这并不意味着不支持 API 版本。你仍然可以调用该版本。它只是一种让 调用API 用户意识到以下版本在将来会被弃用。
上面把Deprecated设置为TRUE表示，版本1.0将来会被弃用。访问我们的API接口，可以在响应头中可以看到，下面信息，如下图所示：
ApiVersionNeutral特性的使用：
ApiVersionNeutral 特性定义此 API 不在支持版本控制。无论 支持api 版本控制或不支持 api 版本控制的旧式 api，这对于行为完全相同的 api 非常有用。因此, 您可以添加 ApiVersionNeutral 属性以从版本控制中退出。
获取版本信息（Version Information）
如果你想知道那个版本的客户端在被访问，你可以通过下面的代码实现该功能：
综上所述, 具有多个版本的 API 可以帮助以一种有效的方式推出增强的功能, 同时也便于跟踪更改。在这篇文章中, 我们看到了如何在 ASP.NET coreWEB API 中添加对多个版本的支持。nuget 包支持通过查询字符串参数进行版本控制, 在 URL 中添加路径段和通过标头。它还具有版本单一 API 操作和从版本中选择退出的功能。
能不能不借助第三方的包来实现一个API的版本控制，方法是有的，不卖关子了，大家接着往下看。
四、终极版本（不借助任何NuGet包）asp.net core web api版本控制
新建一个core API项目：
在VersionControl文件夹下面，新建一个实现了IApplicationModelConvention接口的类NameSpaceVersionRoutingConvention代码如下：
public class NameSpaceVersionRoutingConvention:IApplicationModelConvention { private readonly string apiPrefix; private const string urlTemplate = "{0}/{1}/{2}"; public NameSpaceVersionRoutingConvention(string apiPrefix = "api") { this.apiPrefix = apiPrefix; } public void Apply(ApplicationModel application) { foreach (var controller in application.Controllers) { var hasRouteAttribute = controller.Selectors .Any(x => x.AttributeRouteModel != null); if (!hasRouteAttribute) { continue; } var nameSpaces = controller.ControllerType.Namespace.Split('.'); //获取namespace中版本号部分 var version = nameSpaces.FirstOrDefault(x => Regex.IsMatch(x, @"^v(\d+)$")); if (string.IsNullOrEmpty(version)) { continue; } string template = string.Format(urlTemplate, apiPrefix, version, controller.ControllerName); controller.Selectors[0].AttributeRouteModel = new AttributeRouteModel() { Template = template }; } } }
调试代码发现这种方式只在程序第一次运行的时候会执行，之后不会再执行多次，因此效率很高。
五、总结：