WebApplicationFactory<TEntryPoint> Kelas

Definisi

Ruang nama:

Microsoft.AspNetCore.Mvc.Testing

Rakitan:

Microsoft.AspNetCore.Mvc.Testing.dll

Paket:

Microsoft.AspNetCore.Mvc.Testing v9.0.2

Sumber:

WebApplicationFactory.cs

Pabrik untuk bootstrapping aplikasi dalam memori untuk pengujian ujung ke ujung fungsi.

generic <typename TEntryPoint>
 where TEntryPoint : classpublic ref class WebApplicationFactory : IDisposable

public class WebApplicationFactory<TEntryPoint> : IAsyncDisposable, IDisposable where TEntryPoint : class

type WebApplicationFactory<'EntryPoint (requires 'EntryPoint : null)> = class
    interface IDisposable
    interface IAsyncDisposable

Public Class WebApplicationFactory(Of TEntryPoint)
Implements IAsyncDisposable, IDisposable

Jenis parameter

TEntryPoint

Jenis dalam rakitan titik entri aplikasi. Biasanya kelas Startup atau Program dapat digunakan.

Warisan

Object

WebApplicationFactory<TEntryPoint>

Penerapan

IAsyncDisposable IDisposable

Konstruktor

WebApplicationFactory<TEntryPoint>()

Membuat instans WebApplicationFactory<TEntryPoint>. Pabrik ini dapat digunakan untuk membuat TestServer instans menggunakan aplikasi MVC yang ditentukan oleh TEntryPoint dan satu atau beberapa HttpClient instans yang digunakan untuk mengirim HttpRequestMessage ke TestServer. WebApplicationFactory<TEntryPoint> akan menemukan kelas titik masuk perakitan TEntryPoint dan menginisialisasi aplikasi dengan memanggil IWebHostBuilder CreateWebHostBuilder(string [] args) di TEntryPoint. Konstruktor ini akan menyimpulkan jalur akar konten aplikasi dengan mencari WebApplicationFactoryContentRootAttribute pada perakitan yang berisi pengujian fungsional dengan kunci yang sama dengan perakitan TEntryPointFullName. Jika atribut dengan kunci yang tepat tidak dapat ditemukan, WebApplicationFactory<TEntryPoint> akan kembali mencari file solusi (*.sln) lalu menambahkan TEntryPoint nama rakitan ke direktori solusi. Direktori akar aplikasi akan digunakan untuk menemukan tampilan dan file konten. Rakitan aplikasi akan dimuat dari konteks dependensi perakitan yang berisi TEntryPoint. Ini berarti bahwa dependensi proyek dari assembly yang berisi TEntryPoint akan dimuat sebagai rakitan aplikasi.

Properti

ClientOptions	Mendapatkan yang WebApplicationFactoryClientOptions digunakan oleh CreateClient().
Factories	Mendapatkan pabrik yang IReadOnlyList<T> dibuat dari pabrik ini dengan menyesuaikan IWebHostBuilder lebih lanjut saat memanggil WithWebHostBuilder(Action<IWebHostBuilder>).
Server	Mendapatkan yang TestServer dibuat oleh ini WebApplicationFactory<TEntryPoint>.
Services	Mendapatkan yang IServiceProvider dibuat oleh server yang terkait dengan ini WebApplicationFactory<TEntryPoint>.

Metode

ConfigureClient(HttpClient)	Mengonfigurasi instans HttpClient yang dibuat oleh ini WebApplicationFactory<TEntryPoint>.
ConfigureWebHost(IWebHostBuilder)	Memberikan kesempatan untuk mengonfigurasi aplikasi sebelum dibangun.
CreateClient()	Membuat instans HttpClient yang secara otomatis mengikuti pengalihan dan menangani cookie.
CreateClient(WebApplicationFactoryClientOptions)	Membuat instans HttpClient yang secara otomatis mengikuti pengalihan dan menangani cookie.
CreateDefaultClient(DelegatingHandler[])	Membuat instans baru dari yang HttpClient dapat digunakan untuk mengirim HttpRequestMessage ke server. Alamat HttpClient dasar instans akan diatur ke http://localhost.
CreateDefaultClient(Uri, DelegatingHandler[])	Membuat instans baru dari yang HttpClient dapat digunakan untuk mengirim HttpRequestMessage ke server.
CreateHost(IHostBuilder)	IHost Membuat dengan aplikasi bootstrap di builder. Ini hanya dipanggil untuk aplikasi yang menggunakan IHostBuilder. Aplikasi berdasarkan IWebHostBuilder akan digunakan CreateServer(IWebHostBuilder) sebagai gantinya.
CreateHostBuilder()	Membuat yang IHostBuilder digunakan untuk menyiapkan TestServer.
CreateServer(IWebHostBuilder)	TestServer Membuat dengan aplikasi bootstrap di builder. Ini hanya dipanggil untuk aplikasi yang menggunakan IWebHostBuilder. Aplikasi berdasarkan IHostBuilder akan digunakan CreateHost(IHostBuilder) sebagai gantinya.
CreateWebHostBuilder()	Membuat yang IWebHostBuilder digunakan untuk menyiapkan TestServer.
Dispose()	Pabrik untuk bootstrapping aplikasi dalam memori untuk pengujian ujung ke ujung fungsi.
Dispose(Boolean)	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola.
DisposeAsync()	Pabrik untuk bootstrapping aplikasi dalam memori untuk pengujian ujung ke ujung fungsi.
Finalize()	Menyelesaikan instans WebApplicationFactory<TEntryPoint> kelas.
GetTestAssemblies()	Mendapatkan rakitan yang berisi tes fungsi. yang WebApplicationFactoryContentRootAttribute diterapkan ke rakitan ini menentukan akar konten yang akan digunakan untuk yang diberikan TEntryPoint.
WithWebHostBuilder(Action<IWebHostBuilder>)	Membuat baru WebApplicationFactory<TEntryPoint> dengan IWebHostBuilder yang dikustomisasi lebih lanjut oleh configuration.