EditContext.ValidateAsync(CancellationToken) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この EditContext を非同期的に検証します。
保留中のフィールド レベルの非同期検証タスクを取り消し、同期 OnValidationRequested ハンドラーを呼び出してから、非同期 OnValidationRequestedAsync ハンドラーを同時に呼び出して待機します。 同期ハンドラーからの例外は呼び出し元に伝達され、 Validate()一致します。 非同期ハンドラーによってスローされるキャンセル以外の例外が含まれています。フォームはエラーとしてマークされ (パラメーターなしの IsValidationFaulted()を介して監視可能)、メソッドは falseを返します。
非同期部分の処理中に、パラメーターなしの IsValidationPending() は true を返して、アプリケーションでグローバルな "検証..." を表示できるようにします。は、呼び出し自体をラップせずにインジケーターを表示します。 フォーム レベルの IsValidationFaulted() 結果は、パスが完了した場合にのみ更新されます。呼び出し元が取り消したパス間で保持されます。
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)パラメーター
- cancellationToken
- CancellationToken
この検証パスのキャンセルを通知するトークン。 トークンは、 CancellationTokenを介して非同期ハンドラーに公開されます。 呼び出し元がトークンを取り消した場合、このメソッドは OperationCanceledExceptionをスローします。その場合、フォームはエラーとしてマークされず、以前のフォーム レベルのエラー状態は保持されます。 トークンは、インフライト パスのみをバインドします。待機中 (ユーザーの編集など) 中に個別に開始されるフィールド レベルの検証タスクは、このトークンにリンクされず、実行を続けます。
返品
True の 場合は、検証後に検証メッセージがなく、非同期ハンドラーにエラーが発生しません。それ以外の場合は false。
例外
検証パスの前または実行中に cancellationToken が取り消されたときにスローされます。
注釈
検証を再入力することはできません。 同じEditContextにアタッチされたOnValidationRequested、OnValidationRequestedAsync、またはOnValidationStateChangedハンドラー内からValidate()またはValidateAsync(CancellationToken)を呼び出さないでください。これにより、未定義の動作が発生します。