OptionsBuilderDataAnnotationsExtensions.ValidateDataAnnotations<TOptions> Metode

Definisi

Ruang nama:

Microsoft.Extensions.DependencyInjection

Rakitan:

Microsoft.Extensions.Options.DataAnnotations.dll

Paket:

Microsoft.Extensions.Options.DataAnnotations v11.0.0-preview.7.26381.103

Sumber:

OptionsBuilderDataAnnotationsExtensions.cs

Mendaftarkan instans opsi ini untuk validasi DataAnnotations-nya.

public:
generic <typename TOptions>
 where TOptions : class[System::Runtime::CompilerServices::Extension]
 static Microsoft::Extensions::Options::OptionsBuilder<TOptions> ^ ValidateDataAnnotations(Microsoft::Extensions::Options::OptionsBuilder<TOptions> ^ optionsBuilder);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Uses DataAnnotationValidateOptions which is unsafe given that the options type passed in when calling Validate cannot be statically analyzed so its members may be trimmed.")]
public static Microsoft.Extensions.Options.OptionsBuilder<TOptions> ValidateDataAnnotations<TOptions>(this Microsoft.Extensions.Options.OptionsBuilder<TOptions> optionsBuilder) where TOptions : class;

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Uses DataAnnotationValidateOptions which is unsafe given that the options type passed in when calling Validate cannot be statically analyzed so its members may be trimmed.")>]
static member ValidateDataAnnotations : Microsoft.Extensions.Options.OptionsBuilder<'Options (requires 'Options : null)> -> Microsoft.Extensions.Options.OptionsBuilder<'Options (requires 'Options : null)> (requires 'Options : null)

<Extension()>
Public Function ValidateDataAnnotations(Of TOptions As Class) (optionsBuilder As OptionsBuilder(Of TOptions)) As OptionsBuilder(Of TOptions)

Jenis parameter

TOptions

Jenis opsi yang akan dikonfigurasi.

Parameter

optionsBuilder

OptionsBuilder<TOptions>

Penyusun opsi untuk menambahkan layanan.

Mengembalikan

OptionsBuilder<TOptions>

OptionsBuilder<TOptions> Sehingga panggilan tambahan dapat ditautkan.

Atribut

RequiresUnreferencedCodeAttribute

Keterangan

Validasi sinkron berjalan saat instans opsi dibuat atau diakses. Saat menargetkan .NET 11 atau yang lebih baru, validasi asinkron (termasuk AsyncValidationAttributeatribut turunan) berjalan sekali saat startup, dan hanya ketika ValidateOnStart() juga dipanggil. Jika ValidateOnStart() tidak dipanggil, atribut yang berasal dari AsyncValidationAttribute tidak pernah dievaluasi secara asinkron: akses opsi runtime hanya memicu validasi sinkron, yang memanggil fallback sinkron atribut sebagai gantinya. Saat menggunakan AsyncValidationAttributeatribut -turunan, pastikan fallback sinkron IsValid tidak melempar: validasi sinkron masih berjalan pada setiap akses opsi, sehingga melemparkan permukaan fallback sebagai pengecualian pada setiap akses (misalnya saat menyelesaikan IOptions{TOptions}.Value), bahkan jika validasi startup berhasil.