Sprache

Validator.TryValidatePropertyAsync Methode

Definition

Testet asynchron, ob der angegebene Eigenschaftswert gültig ist.

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The Type of validationContext.ObjectType cannot be statically discovered.")]
public static System.Threading.Tasks.Task<bool> TryValidatePropertyAsync(object? value, System.ComponentModel.DataAnnotations.ValidationContext validationContext, System.Collections.Generic.ICollection<System.ComponentModel.DataAnnotations.ValidationResult>? validationResults, System.Threading.CancellationToken cancellationToken = default);
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The Type of validationContext.ObjectType cannot be statically discovered.")>]
static member TryValidatePropertyAsync : obj * System.ComponentModel.DataAnnotations.ValidationContext * System.Collections.Generic.ICollection<System.ComponentModel.DataAnnotations.ValidationResult> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Shared Function TryValidatePropertyAsync (value As Object, validationContext As ValidationContext, validationResults As ICollection(Of ValidationResult), Optional cancellationToken As CancellationToken = Nothing) As Task(Of Boolean)

Parameter

value
Object

Der zu testende Wert

validationContext
ValidationContext

Beschreibt das Eigenschaftenmember zum Überprüfen und Bereitstellen von Diensten und Kontext für die Validatoren.

validationResults
ICollection<ValidationResult>

Eine optionale Auflistung, die Überprüfungsfehler als ValidationResult Instanzen empfängt.

cancellationToken
CancellationToken

A CancellationToken , um zu beobachten, während sie auf den Abschluss der Aufgabe warten.

Gibt zurück

Ein Task<TResult> Wert, true der gültig ist, false wenn Überprüfungsfehler aufgetreten sind.

Attribute

Ausnahmen

validationContextist nulloder ist null oder MemberName leer.

MemberName identifiziert keine gültige öffentliche, nicht indexer-Eigenschaft oder value kann dieser Eigenschaft nicht zugewiesen werden.

Der Überprüfungsvorgang wurde abgebrochen.

Hinweise

Diese Methode testet jede ValidationAttribute zugeordnete Eigenschaft, die von validationContext. Wenn validationResults die Methode nicht null ist, wird dieser Methode für jeden Überprüfungsfehler ein Add-In ValidationResult hinzugefügt.

Wenn eine RequiredAttribute Eigenschaft gefunden wird, wird sie vor allen anderen Überprüfungsattributen ausgewertet. Wenn der erforderliche Validator fehlschlägt, stoppt die Überprüfung, und fügt diese einzelne Fehler der validationResults Auflistung hinzu, wenn zutreffend und zurückgegeben wird false.

Alle AsyncValidationAttribute Instanzen werden asynchron ausgewertet, nachdem alle synchronen Überprüfungsattribute bestanden wurden.

Gilt für: