输出缓存 API 更改

Microsoft.AspNetCore.OutputCaching 命名空间中的某些 API 已更改，能够更好地表示其意图。

删除了以下 API：

• OutputCachePolicyBuilder.#ctor
• OutputCachePolicyBuilder.Clear

以下 API 已重命名：

原名称	新名称
AllowLocking(System.Boolean)	SetLocking(Boolean)
VaryByRouteValue(System.String[])	SetVaryByRouteValue(String[])
VaryByQuery(System.String[])	SetVaryByQuery(String[])
VaryByHeader(System.String[])	SetVaryByHeader(String[])

以下 API 已添加：

• CacheVaryByRules.VaryByHost
• OutputCacheOptions.AddPolicy(String, Action<OutputCachePolicyBuilder>, Boolean)
• OutputCacheOptions.AddBasePolicy(Action<OutputCachePolicyBuilder>, Boolean)
• Microsoft.Extensions.DependencyInjection.OutputCacheConventionBuilderExtensions.CacheOutput<TBuilder>(TBuilder, Action<OutputCachePolicyBuilder>, Boolean)

引入的版本

ASP.NET Core 7.0 RC 2

旧行为

OutputCachePolicyBuilder.VaryByQuery(System.String[]) 是累加的：每个调用都添加了更多的查询字符串键。

新行为

OutputCachePolicyBuilder.VaryByQuery(System.String[]) 方法现已命名为 OutputCachePolicyBuilder.SetVaryByQuery(String[])，每个调用会替换现有的查询字符串键。

有关其他更改，请参阅本文的第一部分。

中断性变更的类型

此更改影响源兼容性和二进制兼容性。

更改原因

这一更改是为了提高方法名称的一致性，并消除其行为中的模糊性。

建议的操作

重新编译使用早期 SDK 生成的任何项目。 如果直接引用了其中任一方法名称，请更新源以反映新名称。

受影响的 API

• Microsoft.AspNetCore.OutputCaching.OutputCachePolicyBuilder.#ctor
• Microsoft.AspNetCore.OutputCaching.OutputCachePolicyBuilder.Clear
• Microsoft.AspNetCore.OutputCaching.OutputCachePolicyBuilder.AllowLocking(System.Boolean)
• Microsoft.AspNetCore.OutputCaching.OutputCachePolicyBuilder.VaryByRouteValue(System.String[])
• Microsoft.AspNetCore.OutputCaching.OutputCachePolicyBuilder.VaryByQuery(System.String[])
• Microsoft.AspNetCore.OutputCaching.OutputCachePolicyBuilder.VaryByHeader(System.String[])