[Breaking change]: Output Caching renames in 7.0 RC2

[sebastienros]

Description

From 7.0 RC1 to 7.0 RC2 some APIs have changed to better represent their intent.

dotnet/aspnetcore#43892

Version

.NET 7 RC2

Previous behavior

• OutputCachePolicyBuilder.VaryByQuery() was additive: every call would add more query string keys to vary by.

New behavior

• OutputCachePolicyBuilder.SetVaryByQuery() is replacing existing query string keys.

Type of breaking change

• Binary incompatible: Existing binaries may encounter a breaking change in behavior, such as failure to load/execute or different run-time behavior.
• Source incompatible: Source code may encounter a breaking change in behavior when targeting the new runtime/component/SDK, such as compile errors or different run-time behavior.
• Behavioral change: Existing code and binaries may experience different run-time behavior.

Reason for change

This change was made to improve the consistency of method names and to remove ambiguity in their behavior.

Recommended action

It is recommended you recompile any projects built with an earlier SDK. If any of these method names were referenced directly, the source should be updated to reflect the new names.

Affected APIs

• Removed: Microsoft.AspNetCore.OutputCaching.OutputCachePolicyBuilder.OutputCachePolicyBuilder()
• Removed: Microsoft.AspNetCore.OutputCaching.OutputCachePolicyBuilder.Clear()
• Renamed: Microsoft.AspNetCore.OutputCaching.OutputCachePolicyBuilder.AllowLocking() to SetLocking()
• Renamed: Microsoft.AspNetCore.OutputCaching.OutputCachePolicyBuilder.VaryByRouteValue() to SetVaryByRouteValue()
• Renamed: Microsoft.AspNetCore.OutputCaching.OutputCachePolicyBuilder.VaryByQuery() to SetVaryByQuery()
• Renamed: Microsoft.AspNetCore.OutputCaching.OutputCachePolicyBuilder.VaryByHeader() to SetVaryByHeader()
• Added: Microsoft.AspNetCore.OutputCaching.CacheVaryByRules.VaryByHost
• Added: Microsoft.AspNetCore.OutputCaching.OutputCacheOptions.AddPolicy(string name, Action<OutputCachePolicyBuilder> build, bool excludeDefaultPolicy)
• Added: Microsoft.AspNetCore.OutputCaching.OutputCacheOptions.AddBasePolicy(Action<OutputCachePolicyBuilder> build, bool excludeDefaultPolicy)
• Added: Microsoft.Extensions.DependencyInjection.OutputCacheConventionBuilderExtensions.CacheOutput<TBuilder>(this TBuilder builder, Action<OutputCachePolicyBuilder> policy, bool excludeDefaultPolicy)