EditContext.ValidateAsync(CancellationToken) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überprüft dies EditContext asynchron.
Bricht alle ausstehenden asynchronen Überprüfungsaufgaben auf Feldebene ab, ruft die synchronen OnValidationRequested Handler auf, ruft sie dann auf und wartet gleichzeitig auf die asynchronen OnValidationRequestedAsync Handler. Ausnahmen von synchronen Handlern werden an den Aufrufer weitergegeben, übereinstimmend Validate(). Jede Ausnahme ohne Abbruch, die von einem asynchronen Handler ausgelöst wird, ist enthalten: Das Formular wird als fehlerhaft markiert (über die Parameterlosigkeit feststellbar IsValidationFaulted()), und die Methode gibt zurück false.
Während sich der asynchrone Teil in Flight befindet, gibt true der parameterlose IsValidationPending() Teil zurück, sodass Anwendungen eine globale "Validierung..." anzeigen können. Indikator, ohne den Anruf selbst umschließen zu müssen. Das Ergebnis auf Formularebene IsValidationFaulted() wird nur aktualisiert, wenn ein Durchlauf abgeschlossen ist. Er wird über gekündigte Durchläufe des Anrufers beibehalten.
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)Parameter
- cancellationToken
- CancellationToken
Ein Token, das den Abbruch dieses Überprüfungsdurchlaufs signalisiert. Das Token wird über asynchrone CancellationTokenHandler verfügbar gemacht. Wenn der Aufrufer das Token abbricht, löst diese Methode aus OperationCanceledException. Das Formular wird in diesem Fall nicht als fehlerhaft markiert, und der vorherige Fehlerstatus auf Formularebene wird beibehalten. Das Token begrenzt nur den In-Flight-Pass; Überprüfungsaufgaben auf Feldebene, die während des erwarteten Fensters (z. B. von Benutzerbearbeitungen) unabhängig gestartet werden, sind nicht mit diesem Token verknüpft und fahren mit der Ausführung fort.
Gibt zurück
True, wenn nach der Überprüfung keine Überprüfungsmeldungen vorhanden sind und kein asynchroner Handler fehlerhaft ist; andernfalls "false".
Ausnahmen
Wird ausgelöst, wenn vor cancellationToken oder während des Überprüfungsdurchlaufs abgebrochen wird.
Hinweise
Die Überprüfung darf nicht erneut eingegeben werden. Rufen Validate()ValidateAsync(CancellationToken) Sie nicht innerhalb eines OnValidationRequested, OnValidationRequestedAsyncoder OnValidationStateChanged Handlers, der an dasselbe EditContextangefügt ist . Dadurch wird ein nicht definiertes Verhalten erzeugt.