Cambios en las API de almacenamiento en caché de salida

Algunas API del espacio de nombres Microsoft.AspNetCore.OutputCaching se han modificado para representar mejor su intención.

Se han quitado las siguientes API:

• OutputCachePolicyBuilder.#ctor
• OutputCachePolicyBuilder.Clear

Se ha cambiado el nombre de las siguientes API:

Nombre anterior	Nombre nuevo
AllowLocking(System.Boolean)	SetLocking(Boolean)
VaryByRouteValue(System.String[])	SetVaryByRouteValue(String[])
VaryByQuery(System.String[])	SetVaryByQuery(String[])
VaryByHeader(System.String[])	SetVaryByHeader(String[])

Se han agregado las siguientes API:

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

Versión introducida

ASP.NET Core 7.0 RC 2

Comportamiento anterior

OutputCachePolicyBuilder.VaryByQuery(System.String[]) era aditivo: cada llamada agregaba más claves de cadena de consulta.

Comportamiento nuevo

El método OutputCachePolicyBuilder.VaryByQuery(System.String[]) ahora se denomina OutputCachePolicyBuilder.SetVaryByQuery(String[]) y cada llamada reemplaza las claves de cadena de consulta que hay.

Para ver otros cambios, consulte la primera sección de este artículo.

Tipo de cambio importante

Este cambio afecta a la compatibilidad del código fuente y a la compatibilidad binaria.

Motivo del cambio

Este cambio se ha realizado para mejorar la coherencia de los nombres de método y eliminar la ambigüedad en su comportamiento.

Acción recomendada

Vuelva a compilar los proyectos compilados con un SDK anterior. Si hace referencia a cualquiera de estos nombres de método directamente, actualice el origen para reflejar los nuevos nombres.

API afectadas

• 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[])