APIs obsoletas Blazor removidas

Um conjunto de APIs nos assemblies Blazor Components marcados anteriormente como obsoletos foram removidos no ASP.NET Core 11. A maioria dessas APIs foi marcada como obsoleta já há várias versões e conta com alternativas funcionais recomendadas há anos.

Versão introduzida

.NET 11

Comportamento anterior

Anteriormente, as APIs afetadas eram compiladas com um aviso obsoleto. A maioria dos avisos apontou para uma API de substituição. Por exemplo, a chamada EditContext.AddDataAnnotationsValidation() produziu um aviso obsoleto recomendando EnableDataAnnotationsValidation.

Novo comportamento

No ASP.NET Core 11, as SEGUINTEs APIs são removidas e não são mais compiladas.

Microsoft.AspNetCore.Components

• Propriedade Router.PreferExactMatches. A propriedade não teve efeito desde que o roteamento de correspondência exata se tornou o padrão em .NET 6.
• ResourceAsset(string url) sobrecarga do construtor.

Microsoft.AspNetCore.Components.Forms

• O método de extensão EditContextDataAnnotationsExtensions.AddDataAnnotationsValidation(EditContext).
• EditContextDataAnnotationsExtensions.EnableDataAnnotationsValidation(EditContext) sobrecarga (a sobrecarga sem um parâmetro IServiceProvider).
• RemoteBrowserFileStreamOptions classe.

Microsoft.AspNetCore.Components.Web

• WebEventCallbackFactoryEventArgsExtensions classe e todos os seus métodos de extensão.
• O init acessor de WebRenderer.RendererId. A propriedade agora é definida apenas pelo construtor.

Microsoft.AspNetCore.Components.WebAssembly

• Método JSInteropMethods.NotifyLocationChanged(string, bool).

Microsoft.AspNetCore.Components.WebAssembly.Authentication

• SignOutSessionStateManager classe. A classe tem sido uma no-op desde .NET 7.
• RemoteAuthenticationService a sobrecarga do construtor que não recebe um registrador.
• o construtor AccessTokenResult e a propriedade RedirectUrl.
• AccessTokenNotAvailableException agora usa InteractiveRequestUrl no lugar do removido RedirectUrl.

Tipo de mudança disruptiva

Essa alteração pode afetar a compatibilidade do código-fonte.

Motivo da alteração

Essas APIs foram marcadas como obsoletas em versões anteriores (a maioria entre .NET 5 e .NET 8). Cada um deles tinha um substituto documentado, e continuar distribuindo a superfície obsoleta aumentava o custo de manutenção e a superfície para Blazor, sem benefício. Para obter mais informações, consulte dotnet/aspnetcore#62755.

Ação recomendada

Atualize seu código para usar as APIs de substituição, conforme listado na tabela a seguir.

APIs afetadas

• Microsoft.AspNetCore.Components.Routing.Router.PreferExactMatches
• Microsoft.AspNetCore.Components.Forms.EditContextDataAnnotationsExtensions.AddDataAnnotationsValidation
• Microsoft.AspNetCore.Components.Forms.EditContextDataAnnotationsExtensions.EnableDataAnnotationsValidation
• Microsoft.AspNetCore.Components.Forms.RemoteBrowserFileStreamOptions
• Microsoft.AspNetCore.Components.Web.WebEventCallbackFactoryEventArgsExtensions
• Microsoft.AspNetCore.Components.RenderTree.WebRenderer.RendererId (acessador init)
• Microsoft.AspNetCore.Components.WebAssembly.Infrastructure.JSInteropMethods.NotifyLocationChanged(System.String, System.Boolean)
• Microsoft.AspNetCore.Components.WebAssembly.Authentication.SignOutSessionStateManager
• Microsoft.AspNetCore.Components.WebAssembly.Authentication.RemoteAuthenticationService<TRemoteAuthenticationState, TAccount, TProviderOptions> (sobrecarga do construtor sem logger)
• Microsoft.AspNetCore.Components.WebAssembly.Authentication.AccessTokenResult (construtor legado e propriedade RedirectUrl)
• Microsoft.AspNetCore.Components.ResourceAsset (sobrecarga do construtor sem properties)