EditContext.ValidateAsync(CancellationToken) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Valide cette opération EditContext de façon asynchrone.
Annule toutes les tâches de validation asynchrone au niveau du champ en attente, appelle les gestionnaires synchrones OnValidationRequested , puis appelle et attend les gestionnaires asynchrones OnValidationRequestedAsync simultanément. Les exceptions des gestionnaires synchrones se propagent à l’appelant, correspondant Validate(). Toute exception non-annulation levée par un gestionnaire asynchrone est contenue : le formulaire est marqué comme défectueux (observable via le paramètreless IsValidationFaulted()) et la méthode retourne false.
Pendant que la partie asynchrone est en cours, les retours true sans IsValidationPending() paramètre permettent aux applications d’afficher une « validation » globale. indicateur sans encapsuler l’appel lui-même. Le résultat au niveau IsValidationFaulted() du formulaire est mis à jour uniquement lorsqu’une passe est terminée ; elle est conservée entre les passes annulées par l’appelant.
public System.Threading.Tasks.Task<bool> ValidateAsync(System.Threading.CancellationToken cancellationToken = default);member this.ValidateAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Function ValidateAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Boolean)Paramètres
- cancellationToken
- CancellationToken
Jeton qui signale l’annulation de cette passe de validation. Le jeton est exposé aux gestionnaires asynchrones via CancellationToken. Si l’appelant annule le jeton, cette méthode lève OperationCanceledException; le formulaire n’est pas marqué comme étant défectueux dans ce cas et l’état d’erreur au niveau du formulaire précédent est conservé. Le jeton limite le pass en cours d’exécution uniquement ; Les tâches de validation au niveau du champ qui démarrent indépendamment pendant la fenêtre attendue (par exemple, à partir des modifications de l’utilisateur) ne sont pas liées à ce jeton et continuent à s’exécuter.
Retours
True s’il n’existe aucun message de validation après la validation et qu’aucun gestionnaire asynchrone n’a été défectueux ; sinon false.
Exceptions
Levée lorsqu’elle cancellationToken est annulée avant ou pendant la passe de validation.
Remarques
La validation ne doit pas être entrée à nouveau. N’appelez pas ou n’entrez Validate() pas à l’intérieur d’un gestionnaire OnValidationRequestedAsyncOnValidationStateChanged ou d’un OnValidationRequestedgestionnaire attaché au même EditContext; cela produit un comportement non défini.ValidateAsync(CancellationToken)