輸出快取 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[])