EditContext.ValidateAsync(CancellationToken) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Проверяет это 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 отмене до или во время прохождения проверки.
Комментарии
Проверка не должна быть введена повторно. Не вызывайте Validate() или ValidateAsync(CancellationToken)OnValidationStateChanged не вызывайте или из OnValidationRequestedOnValidationRequestedAsyncнее или обработчик, подключенный к тому жеEditContext, что делает это неопределенным поведением.