Validator.TryValidateObjectAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| 속성 | Description |
|---|---|
| TryValidateObjectAsync(Object, ValidationContext, ICollection<ValidationResult>, CancellationToken) |
지정된 개체 인스턴스가 유효한지 여부를 비동기적으로 테스트합니다. |
| TryValidateObjectAsync(Object, ValidationContext, ICollection<ValidationResult>, Boolean, CancellationToken) |
지정된 개체 인스턴스가 유효한지 여부를 비동기적으로 테스트합니다. |
TryValidateObjectAsync(Object, ValidationContext, ICollection<ValidationResult>, CancellationToken)
- Source:
- Validator.cs
지정된 개체 인스턴스가 유효한지 여부를 비동기적으로 테스트합니다.
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Constructing a ValidationContext without a display name is not trim-safe because it uses reflection to discover the type of the instance being validated in order to resolve the DisplayNameAttribute when a display name is not provided.")]
public static System.Threading.Tasks.Task<bool> TryValidateObjectAsync(object instance, System.ComponentModel.DataAnnotations.ValidationContext validationContext, System.Collections.Generic.ICollection<System.ComponentModel.DataAnnotations.ValidationResult>? validationResults, System.Threading.CancellationToken cancellationToken = default);[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Constructing a ValidationContext without a display name is not trim-safe because it uses reflection to discover the type of the instance being validated in order to resolve the DisplayNameAttribute when a display name is not provided.")>]
static member TryValidateObjectAsync : obj * System.ComponentModel.DataAnnotations.ValidationContext * System.Collections.Generic.ICollection<System.ComponentModel.DataAnnotations.ValidationResult> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Shared Function TryValidateObjectAsync (instance As Object, validationContext As ValidationContext, validationResults As ICollection(Of ValidationResult), Optional cancellationToken As CancellationToken = Nothing) As Task(Of Boolean)매개 변수
- instance
- Object
테스트할 개체 인스턴스입니다.
null수 없습니다.
- validationContext
- ValidationContext
유효성을 검사할 개체를 설명하고 유효성 검사기에 대한 서비스 및 컨텍스트를 제공합니다.
- validationResults
- ICollection<ValidationResult>
인스턴스로 ValidationResult 유효성 검사 실패를 수신하는 선택적 컬렉션입니다.
- cancellationToken
- CancellationToken
CancellationToken 작업이 완료 될 때까지 기다리는 동안 관찰할 A입니다.
반품
Task<TResult>
true 즉, false 유효성 검사 오류가 발생한 경우 개체가 유효한 경우입니다.
- 특성
예외
시기 instance 입니다.null
시기 validationContext 입니다.null
onvalidationContext과 일치하지 않는 경우instance.ObjectInstance
유효성 검사 작업이 취소되었습니다.
설명
이 메서드는 개체 인스턴스의 형식에 연결된 모든 ValidationAttribute것을 평가합니다. 또한 표시된 RequiredAttribute 모든 속성이 설정되어 있는지 확인합니다. 로 설정된 true상태에서 호출 validateAllProperties 되지 않는 한 TryValidateObjectAsync(Object, ValidationContext, ICollection<ValidationResult>, Boolean, CancellationToken) 개체의 개별 속성에 대한 s의 유효성을 검사ValidationAttribute하지 않습니다.
유효성 검사는 속성 유효성 검사, 형식 수준 특성 유효성 검사 및 개체 수준 유효성 검사의 세 단계로 실행됩니다. 각 스테이지는 이전 단계가 성공한 경우에만 실행됩니다. 개체 수준 유효성 검사는 동기 인터페이스만 구현하는 ValidateAsync(ValidationContext, CancellationToken) 개체에 대한 대체(fallback)로 구현될 Validate(ValidationContext) 때 호출하는 것을 선호합니다. 둘 다 호출하지는 않습니다.
적용 대상
TryValidateObjectAsync(Object, ValidationContext, ICollection<ValidationResult>, Boolean, CancellationToken)
- Source:
- Validator.cs
지정된 개체 인스턴스가 유효한지 여부를 비동기적으로 테스트합니다.
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Constructing a ValidationContext without a display name is not trim-safe because it uses reflection to discover the type of the instance being validated in order to resolve the DisplayNameAttribute when a display name is not provided.")]
public static System.Threading.Tasks.Task<bool> TryValidateObjectAsync(object instance, System.ComponentModel.DataAnnotations.ValidationContext validationContext, System.Collections.Generic.ICollection<System.ComponentModel.DataAnnotations.ValidationResult>? validationResults, bool validateAllProperties, System.Threading.CancellationToken cancellationToken = default);[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Constructing a ValidationContext without a display name is not trim-safe because it uses reflection to discover the type of the instance being validated in order to resolve the DisplayNameAttribute when a display name is not provided.")>]
static member TryValidateObjectAsync : obj * System.ComponentModel.DataAnnotations.ValidationContext * System.Collections.Generic.ICollection<System.ComponentModel.DataAnnotations.ValidationResult> * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Shared Function TryValidateObjectAsync (instance As Object, validationContext As ValidationContext, validationResults As ICollection(Of ValidationResult), validateAllProperties As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Boolean)매개 변수
- instance
- Object
테스트할 개체 인스턴스입니다.
null수 없습니다.
- validationContext
- ValidationContext
유효성을 검사할 개체를 설명하고 유효성 검사기에 대한 서비스 및 컨텍스트를 제공합니다.
- validationResults
- ICollection<ValidationResult>
인스턴스로 ValidationResult 유효성 검사 실패를 수신하는 선택적 컬렉션입니다.
- validateAllProperties
- Boolean
이 경우 true개체의 모든 속성도 평가합니다(이 프로세스는 속성의 속성에 대해 재귀적이지 않음).
- cancellationToken
- CancellationToken
CancellationToken 작업이 완료 될 때까지 기다리는 동안 관찰할 A입니다.
반품
Task<TResult>
true 즉, false 유효성 검사 오류가 발생한 경우 개체가 유효한 경우입니다.
- 특성
예외
시기 instance 입니다.null
시기 validationContext 입니다.null
onvalidationContext과 일치하지 않는 경우instance.ObjectInstance
유효성 검사 작업이 취소되었습니다.
설명
이 메서드는 개체 인스턴스의 형식에 연결된 모든 ValidationAttribute것을 평가합니다. 또한 표시된 RequiredAttribute 모든 속성이 설정되어 있는지 확인합니다.
true이 경우 validateAllProperties 이 메서드는 이 개체의 ValidationAttribute모든 직속 속성에 대해서도 s를 평가합니다. 이 프로세스는 재귀적이지 않습니다.
이 경우 validateAllPropertiestrue각 속성에 대한 유효성 검사가 순서대로 시작됩니다. 속성의 비동기 특성이 대기되기 전에 속성에 대한 동기 특성이 실행됩니다. 진행 중인 비동기 유효성 검사는 다른 속성에 대한 비동기 유효성 검사와 겹칠 수 있습니다.
이 경우 validationResultsnull첫 번째 속성 오류(교차 속성 단락) 후에 유효성 검사가 중지됩니다. 다른 속성의 모든 진행 중인 비동기 유효성 검사기는 협조적으로 취소됩니다. null이 아닌 경우 validationResults 모든 속성이 완료되고 모든 오류가 수집됩니다.
Task<TResult> 와 같은 Task.WhenAllTask.WhenAny표준 비동기 컴퍼지션 패턴과의 상호 운용성을 반환합니다.
유효성 검사는 속성 유효성 검사, 형식 수준 특성 유효성 검사 및 개체 수준 유효성 검사의 세 단계로 실행됩니다. 각 스테이지는 이전 단계가 성공한 경우에만 실행됩니다. 개체 수준 유효성 검사는 동기 인터페이스만 구현하는 ValidateAsync(ValidationContext, CancellationToken) 개체에 대한 대체(fallback)로 구현될 Validate(ValidationContext) 때 호출하는 것을 선호합니다. 둘 다 호출하지는 않습니다.
