DataAnnotationValidateOptions<TOptions>.ValidateAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Valideert asynchroon een specifiek exemplaar van benoemde opties (of alles wanneer name null is).
public System.Threading.Tasks.Task<Microsoft.Extensions.Options.ValidateOptionsResult> ValidateAsync(string? name, TOptions options, System.Threading.CancellationToken cancellationToken = default);
abstract member ValidateAsync : string * 'Options * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Extensions.Options.ValidateOptionsResult>
override this.ValidateAsync : string * 'Options * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Extensions.Options.ValidateOptionsResult>
Public Function ValidateAsync (name As String, options As TOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ValidateOptionsResult)
Parameters
- name
- String
De naam van het exemplaar van de opties dat wordt gevalideerd.
- options
- TOptions
Het exemplaar van de opties.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Het ValidateOptionsResult resultaat.
Implementeringen
Opmerkingen
Het ingebouwde pad naar asynchrone opties roept deze methode aan in plaats van Validate(String, TOptions). Met deze methode worden volledige DataAnnotations-validatie uitgevoerd, inclusief synchrone en asynchrone kenmerken, en worden leden die zijn gemarkeerd ValidateObjectMembersAttribute met of ValidateEnumeratedItemsAttributerecursief gevalideerd. De cancellationToken wordt doorgegeven van Host.StartAsync(CancellationToken). Standaard wordt er geen opstarttime-out toegepast. Configureer HostOptions.StartupTimeout of geef een CancellationToken met een time-out door aan Host.StartAsync afhankelijke I/O-afhankelijke asynchrone validators:
builder.Services.Configure<HostOptions>(opts =>
opts.StartupTimeout = TimeSpan.FromSeconds(30));
Annuleren gebeurt in samenwerking. Validatieopruiming wacht op het werk, dus een validator die het token negeert, kan de voltooiing vertragen. Annulering van een time-out gekoppeld tokenverzoek; het dwingt geen harde voltooiingsdeadline af.