AsyncValidationAttribute.GetValidationResultAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Проверяет, является ли данный параметр value допустимым асинхронно в отношении текущего атрибута проверки, не вызывая ValidationExceptionисключение.
public System.Threading.Tasks.Task<System.ComponentModel.DataAnnotations.ValidationResult?> GetValidationResultAsync(object? value, System.ComponentModel.DataAnnotations.ValidationContext validationContext, System.Threading.CancellationToken cancellationToken = default);member this.GetValidationResultAsync : obj * System.ComponentModel.DataAnnotations.ValidationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.ComponentModel.DataAnnotations.ValidationResult>Public Function GetValidationResultAsync (value As Object, validationContext As ValidationContext, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ValidationResult)Параметры
- value
- Object
Значение, которое требуется проверить.
- validationContext
- ValidationContext
ValidationContext Экземпляр, предоставляющий контекст операции проверки, например проверяемый объект и член. Предоставляет доступ к службам, необходимым для выполнения проверки с помощью IServiceProvider.
- cancellationToken
- CancellationToken
Необходимо CancellationToken наблюдать за ожиданием завершения задачи.
Возвращаемое значение
Представляет Task<TResult> асинхронную операцию проверки.
Если проверка допустима, результатом является Success.
Если проверка недопустима, результатом является экземпляр ValidationResult.
Исключения
Текущий атрибут неправильно сформирован.
Когда validationContext есть null.
Операция проверки отменена.
Комментарии
Базовая IsValidAsync(Object, ValidationContext, CancellationToken) реализация должна быстро наблюдать за предоставленной cancellationToken и остановкой работы при запросе отмены. Инфраструктура проверки ожидает всех запущенных задач проверки перед возвратом, поэтому реализация, которая игнорирует отмену, может отложить сбой и короткое замыкание.
Вызывающие абоненты, которые должны привязать время проверки, должны передавать маркер, настроенный для отмены после времени ожидания, например один из настроенных CancellationTokenSourceCancelAfter(TimeSpan).
