EditContext.ValidateAsync(CancellationToken) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Ověří to EditContext asynchronně.
Zruší všechny čekající úlohy asynchronního ověřování na úrovni pole, vyvolá synchronní obslužné OnValidationRequested rutiny a pak vyvolá a čeká asynchronní OnValidationRequestedAsync obslužné rutiny souběžně. Výjimky z synchronních obslužných rutin se šíří do volajícího, odpovídající Validate(). Jakákoli výjimka bez zrušení vyvolaná asynchronní obslužnou rutinou je obsažena: formulář je označen jako chybný (pozorovatelný prostřednictvím parametru IsValidationFaulted()) a metoda vrátí false.
I když je asynchronní část v letu, vrátí se true bez IsValidationPending() parametrů, aby aplikace mohly zobrazit globální "ověřování..." bez zabalení samotného volání. Výsledek na úrovni IsValidationFaulted() formuláře se aktualizuje jenom v případech, kdy se průchod dokončí. Zachová se napříč průchody zrušenými volajícími.
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)Parametry
- cancellationToken
- CancellationToken
Token, který signalizuje zrušení tohoto ověřovacího průchodu. Token je zpřístupněn asynchronním obslužným rutinům prostřednictvím CancellationToken. Pokud volající token zruší, tato metoda OperationCanceledExceptionvyvolá ; formulář není v takovém případě označen jako chybný a předchozí stav chyby na úrovni formuláře je zachován. Token ohraničuje pouze letový průchod; Úkoly ověřování na úrovni pole, které se spouští nezávisle během očekávaného okna (například z úprav uživatelů), nejsou propojeny s tímto tokenem a pokračovat ve spuštění.
Návraty
True Pokud neexistují žádné ověřovací zprávy po ověření a žádná asynchronní obslužná rutina byla chybná; jinak nepravda.
Výjimky
Vyvolá se při cancellationToken zrušení před nebo během ověření.
Poznámky
Ověření nesmí být znovu zadáno. Nevolejte ani nevolejte Validate() uvnitř ValidateAsync(CancellationToken) objektu OnValidationRequested, OnValidationRequestedAsyncnebo OnValidationStateChanged obslužné rutiny připojené ke stejnému EditContext; tím vznikne nedefinované chování.