Validator.ValidateObjectAsync Yöntem

Tanım

Ad Alanı:

System.ComponentModel.DataAnnotations

Bütünleştirilmiş Kod:

System.ComponentModel.Annotations.dll

Aşırı Yüklemeler

Veri Akışı Adı	Description
ValidateObjectAsync(Object, ValidationContext, CancellationToken)	Verilen instance geçerli değilse zaman uyumsuz olarak bir ValidationException oluşturur.
ValidateObjectAsync(Object, ValidationContext, Boolean, CancellationToken)	Verilen nesne örneği geçerli değilse zaman uyumsuz olarak bir ValidationException oluşturur.

ValidateObjectAsync(Object, ValidationContext, CancellationToken)

Kaynak:

Validator.cs

Verilen instance geçerli değilse zaman uyumsuz olarak bir ValidationException oluşturur.

[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 ValidateObjectAsync(object instance, System.ComponentModel.DataAnnotations.ValidationContext validationContext, 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 ValidateObjectAsync : obj * System.ComponentModel.DataAnnotations.ValidationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ValidateObjectAsync (instance As Object, validationContext As ValidationContext, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

instance

Object

Test etmek için nesne örneği. nullolamaz.

validationContext

ValidationContext

Doğrulanan nesneyi açıklar ve doğrulayıcılar için hizmetler ve bağlam sağlar.

cancellationToken

CancellationToken

CancellationToken Görevin tamamlanmasını beklerken gözlemlemek için bir.

Döndürülenler

Task

Task Zaman uyumsuz doğrulama işlemini temsil eden.

Öznitelikler

RequiresUnreferencedCodeAttribute

Özel durumlar

ArgumentNullException

olduğunda instancenull.

ArgumentNullException

olduğunda validationContextnull.

ArgumentException

üzerinde instance ile ObjectInstancevalidationContexteşleşmediğinde.

ValidationException

Geçersiz olduğu belirlendiğinde instance .

OperationCanceledException

Doğrulama işlemi iptal edildi.

Açıklamalar

Bu yöntem, nesnenin RequiredAttribute özelliklerindeki öznitelikleri denetler. Özellik doğrulaması başarılı olursa, yöntemi nesnenin ValidationAttribute türüne eklenen öznitelikleri değerlendirir.

Bu aşırı yükleme diğer özellik düzeyi doğrulama özniteliklerini değerlendirmez. Bu öznitelikleri değerlendirmek için, bu bağımsız değişken olarak ayarlanmış olarak kabul eden validateAllProperties aşırı yüklemeyi çağırın true.

Doğrulama üç aşamada çalışır: özellik doğrulaması, tür düzeyi öznitelik doğrulaması ve nesne düzeyi doğrulama. Her aşama yalnızca önceki aşamalar başarılı olursa çalışır. Nesne düzeyinde doğrulama, Validate(ValidationContext) yalnızca zaman uyumlu arabirimi uygulayan nesneler için geri dönüş olarak uygulandığında çağırmayı ValidateAsync(ValidationContext, CancellationToken) tercih eder. Her ikisini de çağırmaz.

ValidateObjectAsync(Object, ValidationContext, Boolean, CancellationToken)

Kaynak:

Validator.cs

Verilen nesne örneği geçerli değilse zaman uyumsuz olarak bir ValidationException oluşturur.

[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 ValidateObjectAsync(object instance, System.ComponentModel.DataAnnotations.ValidationContext validationContext, 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 ValidateObjectAsync : obj * System.ComponentModel.DataAnnotations.ValidationContext * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ValidateObjectAsync (instance As Object, validationContext As ValidationContext, validateAllProperties As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

instance

Object

Test etmek için nesne örneği. nullolamaz.

validationContext

ValidationContext

Doğrulanan nesneyi açıklar ve doğrulayıcılar için hizmetler ve bağlam sağlar.

validateAllProperties

Boolean

ise true, tüm instanceözelliklerini de doğrular.

cancellationToken

CancellationToken

CancellationToken Görevin tamamlanmasını beklerken gözlemlemek için bir.

Döndürülenler

Task

Task Zaman uyumsuz doğrulama işlemini temsil eden.

Öznitelikler

RequiresUnreferencedCodeAttribute

Özel durumlar

ArgumentNullException

olduğunda instancenull.

ArgumentNullException

olduğunda validationContextnull.

ArgumentException

üzerinde instance ile ObjectInstancevalidationContexteşleşmediğinde.

ValidationException

Geçersiz olduğu belirlendiğinde instance .

OperationCanceledException

Doğrulama işlemi iptal edildi.

Açıklamalar

Bu yöntem, olduğunda validateAllPropertiesfalsebile nesnenin özelliklerindeki öznitelikleri denetlerRequiredAttribute. Özellik doğrulaması başarılı olursa, yöntemi nesnenin ValidationAttribute türüne eklenen öznitelikleri değerlendirir.

ise validateAllPropertiestrueyöntemi, nesnenin anlık özelliklerindeki diğer doğrulama özniteliklerini de değerlendirir. Bu işlem, özellik değerlerini yinelemeli olarak doğrulamaz.

Doğrulama üç aşamada çalışır: özellik doğrulaması, tür düzeyi öznitelik doğrulaması ve nesne düzeyi doğrulama. Her aşama yalnızca önceki aşamalar başarılı olursa çalışır. Nesne düzeyinde doğrulama, Validate(ValidationContext) yalnızca zaman uyumlu arabirimi uygulayan nesneler için geri dönüş olarak uygulandığında çağırmayı ValidateAsync(ValidationContext, CancellationToken) tercih eder. Her ikisini de çağırmaz.