EditContext.ValidateAsync(CancellationToken) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Convalida questa operazione EditContext in modo asincrono.
Annulla tutte le attività di convalida asincrone a livello di campo in sospeso, richiama i gestori sincroni OnValidationRequested , quindi richiama e attende i gestori asincroni OnValidationRequestedAsync contemporaneamente. Le eccezioni dei gestori sincroni vengono propagate al chiamante, corrispondente Validate()a . Qualsiasi eccezione non di annullamento generata da un gestore asincrono è contenuta: il modulo viene contrassegnato come difettoso (osservabile tramite l'oggetto senza IsValidationFaulted()parametri ) e il metodo restituisce false.
Mentre la parte asincrona è in anteprima, il risultato senza IsValidationPending() parametri viene restituito true in modo che le applicazioni possano visualizzare una "convalida" globale. indicatore senza avvolgere la chiamata stessa. Il risultato a livello IsValidationFaulted() di modulo viene aggiornato solo al completamento di un passaggio, che viene mantenuto tra i passaggi annullati dal chiamante.
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)Parametri
- cancellationToken
- CancellationToken
Token che segnala l'annullamento del passaggio di convalida. Il token viene esposto ai gestori asincroni tramite CancellationToken. Se il chiamante annulla il token, questo metodo genera OperationCanceledException; il modulo non viene contrassegnato come difettoso in questo caso e lo stato di errore a livello di modulo precedente viene mantenuto. Il token delimita solo il passaggio in anteprima; le attività di convalida a livello di campo che iniziano in modo indipendente durante la finestra attesa (ad esempio, dalle modifiche dell'utente) non sono collegate a questo token e continuano a essere in esecuzione.
Valori restituiti
True se non sono presenti messaggi di convalida dopo la convalida e nessun gestore asincrono non ha avuto esito positivo; in caso contrario false.
Eccezioni
Generata quando cancellationToken viene annullato prima o durante il passaggio di convalida.
Commenti
La convalida non deve essere nuovamente immessa. Non chiamare Validate() o ValidateAsync(CancellationToken) dall'interno di un OnValidationRequestedgestore , OnValidationRequestedAsynco OnValidationStateChanged collegato allo stesso EditContextoggetto . In questo modo, viene generato un comportamento non definito.