ValidationLocalizationServiceCollectionExtensions.AddValidationLocalization Metodo

Origine:

ValidationLocalizationServiceCollectionExtensions.cs

public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddValidationLocalization(this Microsoft.Extensions.DependencyInjection.IServiceCollection services, Action<Microsoft.Extensions.Validation.Localization.ValidationLocalizationOptions>? configureOptions = default);

static member AddValidationLocalization : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<Microsoft.Extensions.Validation.Localization.ValidationLocalizationOptions> -> Microsoft.Extensions.DependencyInjection.IServiceCollection

<Extension()>
Public Function AddValidationLocalization (services As IServiceCollection, Optional configureOptions As Action(Of ValidationLocalizationOptions) = Nothing) As IServiceCollection

Parametri

Valori restituiti

Oggetto IServiceCollection per il concatenamento.

Commenti

Internamente chiama AddLocalization(IServiceCollection) per assicurarsi che un IStringLocalizerFactory sia registrato e registra un bridge IConfigureOptions<TOptions> che imposta Localizer su un'istanza di Microsoft.Extensions.Validation.Localization.DefaultValidationLocalizer (solo quando Localizer non è già stato impostato).

Chiamare AddValidation() separatamente per registrare la pipeline di convalida stessa. L'ordine di chiamata non è importante.

Convalida minima dei parametri API: i parametri api minimi di primo livello non hanno un tipo dichiarante. Per le applicazioni che convalidano i parametri API minimi, preferisce l'overload AddValidationLocalization<TResource>(IServiceCollection, Action<ValidationLocalizationOptions>) (modello di risorsa condivisa) o impostarlo LocalizerProvider in modo esplicito su un delegato che non dipende dal tipo dichiarante (che viene passato come null nel caso del parametro).

L'impostazione predefinita IStringLocalizerFactory registrata da AddLocalization() legge le stringhe dai file di risorse resx. Per localizzare le altre origini (database, file JSON, dizionari in memoria, servizi di traduzione di terze parti), registrare la propria IStringLocalizerFactory implementazione prima o dopo AddValidationLocalization(IServiceCollection, Action<ValidationLocalizationOptions>). Il localizzatore di convalida risolve la factory in fase di convalida, quindi l'ordine di registrazione non è importante:

builder.Services.AddValidation();
builder.Services.AddValidationLocalization();
builder.Services.AddSingleton<IStringLocalizerFactory, MyDatabaseLocalizerFactory>();

Origine:

ValidationLocalizationServiceCollectionExtensions.cs

public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddValidationLocalization<TResource>(this Microsoft.Extensions.DependencyInjection.IServiceCollection services, Action<Microsoft.Extensions.Validation.Localization.ValidationLocalizationOptions>? configureOptions = default);

static member AddValidationLocalization : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<Microsoft.Extensions.Validation.Localization.ValidationLocalizationOptions> -> Microsoft.Extensions.DependencyInjection.IServiceCollection

<Extension()>
Public Function AddValidationLocalization(Of TResource) (services As IServiceCollection, Optional configureOptions As Action(Of ValidationLocalizationOptions) = Nothing) As IServiceCollection

Parametri di tipo

Parametri

Valori restituiti

Oggetto IServiceCollection per il concatenamento.

Commenti

Usare questa opzione quando i messaggi di convalida si trovano in un singolo file di risorse condiviso anziché in file di risorse per tipo.

Equivalente all'impostazione LocalizerProvider su (_, factory) => factory.Create(typeof(TResource)), ma il provider configurato risolve IStringLocalizer una volta e riutilizza la stessa istanza per ogni tipo dichiarante, evitando ripetute ricerche di factory.