Méthode AddDataAnnotationsValidation rendue obsolète

La méthode EditContextDataAnnotationsExtensions.AddDataAnnotationsValidation(EditContext) d’extension est marquée comme obsolète à partir de ASP.NET Core 6. Les développeurs doivent utiliser la nouvelle méthode EditContextDataAnnotationsExtensions.EnableDataAnnotationsValidation d’extension à la place.

La seule différence entre ces deux API est leur valeur de retour :

EditContext AddDataAnnotationsValidation(this EditContext editContext) { ... }

IDisposable EnableDataAnnotationsValidation(this EditContext editContext) { ... }

Version introduite

ASP.NET Core 6.0

Ancien comportement

L'ancienne API, AddDataAnnotationsValidation(EditContext), retourne son EditContext (en tant que type d'API fluide).

Nouveau comportement

La nouvelle API, EnableDataAnnotationsValidation, renvoie un IDisposable dont la libération peut être utilisée pour retirer le support de validation des annotations de données du EditContext.

Raison de la modification

Il existe des cas où il est souhaitable de supprimer la prise en charge de la validation des annotations de données après l’avoir ajoutée. Cela n’était pas possible avec l’ANCIENNE API, car il n’y avait aucun emplacement pour stocker les abonnements aux événements internes. La nouvelle API retourne un objet qui contient l’état nécessaire pour supprimer la prise en charge de la validation des annotations de données lors de l’élimination.

La plupart des applications n’ont pas besoin d’être modifiées. L’utilisation directe de ces méthodes d’extension est un cas rare et avancé. Si votre application utilise le <DataAnnotationsValidator> composant au lieu d’appeler cette méthode directement, elle n’a pas besoin d’être modifiée.

Toutefois, si vous appelez editContext.AddDataAnnotationsValidation(), remplacez cet appel par editContext.EnableDataAnnotationsValidation(). Si vous le souhaitez, capturez le nouvel objet retourné IDisposable et supprimez-le ultérieurement si vous souhaitez annuler les effets de l’appel.

API affectées