WebApplicationFactory<TEntryPoint> Klasa

Definicja

Przestrzeń nazw:

Microsoft.AspNetCore.Mvc.Testing

Zestaw:

Microsoft.AspNetCore.Mvc.Testing.dll

Pakiet:

Microsoft.AspNetCore.Mvc.Testing v8.0.0

Fabryka rozruchu aplikacji w pamięci na potrzeby testów końcowych funkcjonalnych.

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

Parametry typu

TEntryPoint

Typ w zestawie punktu wejścia aplikacji. Zazwyczaj można użyć klas Startup lub Program.

Dziedziczenie

Object

WebApplicationFactory<TEntryPoint>

Implementuje

IDisposable IAsyncDisposable

Konstruktory

WebApplicationFactory<TEntryPoint>()

Tworzy wystąpienie klasy WebApplicationFactory<TEntryPoint>. Ta fabryka może służyć do tworzenia TestServer wystąpienia przy użyciu aplikacji MVC zdefiniowanej przez TEntryPoint program i co najmniej jednego HttpClient wystąpienia używanego do wysyłania HttpRequestMessage do klasy TestServer. Element WebApplicationFactory<TEntryPoint> znajdzie klasę TEntryPoint punktu wejścia zestawu i zainicjuje aplikację przez wywołanie IWebHostBuilder CreateWebHostBuilder(string [] args) metody .TEntryPoint Ten konstruktor wywnioskuje ścieżkę katalogu głównego zawartości aplikacji, wyszukując WebApplicationFactoryContentRootAttribute element w zestawie zawierającym testy funkcjonalne z kluczem równym zestawowi TEntryPointFullName. Jeśli nie można odnaleźć atrybutu z odpowiednim kluczem, WebApplicationFactory<TEntryPoint> powróci do wyszukiwania pliku rozwiązania (*.sln), a następnie dołączania TEntryPoint nazwy zestawu do katalogu rozwiązania. Katalog główny aplikacji będzie używany do odnajdywania widoków i plików zawartości. Zestawy aplikacji zostaną załadowane z kontekstu zależności zestawu zawierającego TEntryPointelement . Oznacza to, że zależności projektu zestawu zawierającego TEntryPoint zostaną załadowane jako zestawy aplikacji.

Właściwości

ClientOptions	Pobiera element używany przez CreateClient()program WebApplicationFactoryClientOptions .
Factories	Pobiera fabryki IReadOnlyList<T> utworzone z tej fabryki, dodatkowo dostosowując element IWebHostBuilder podczas wywoływania metody WithWebHostBuilder(Action<IWebHostBuilder>).
Server	Pobiera utworzony przez ten WebApplicationFactory<TEntryPoint>element TestServer .
Services	Pobiera utworzony IServiceProvider przez serwer skojarzony z tym WebApplicationFactory<TEntryPoint>elementem .

Metody

ConfigureClient(HttpClient)	Konfiguruje HttpClient wystąpienia utworzone przez ten WebApplicationFactory<TEntryPoint>program .
ConfigureWebHost(IWebHostBuilder)	Daje urządzeniu możliwość skonfigurowania aplikacji przed jej skompilowanie.
CreateClient()	Tworzy wystąpienie tego HttpClient obiektu automatycznie podąża za przekierowaniami i obsługuje pliki cookie.
CreateClient(WebApplicationFactoryClientOptions)	Tworzy wystąpienie tego HttpClient obiektu automatycznie podąża za przekierowaniami i obsługuje pliki cookie.
CreateDefaultClient(DelegatingHandler[])	Tworzy nowe wystąpienie obiektu HttpClient , które może służyć do wysyłania HttpRequestMessage do serwera. Podstawowy adres HttpClient wystąpienia zostanie ustawiony na http://localhostwartość .
CreateDefaultClient(Uri, DelegatingHandler[])	Tworzy nowe wystąpienie obiektu HttpClient , które może służyć do wysyłania HttpRequestMessage do serwera.
CreateHost(IHostBuilder)	Tworzy element za IHost pomocą bootstrapped aplikacji w pliku builder. Jest to wywoływane tylko w przypadku aplikacji korzystających z polecenia IHostBuilder. Zamiast tego będą używane CreateServer(IWebHostBuilder) aplikacje oparte naIWebHostBuilder.
CreateHostBuilder()	Tworzy element IHostBuilder używany do konfigurowania .TestServer
CreateServer(IWebHostBuilder)	Tworzy element za TestServer pomocą bootstrapped aplikacji w pliku builder. Jest to wywoływane tylko w przypadku aplikacji korzystających z polecenia IWebHostBuilder. Zamiast tego będą używane CreateHost(IHostBuilder) aplikacje oparte naIHostBuilder.
CreateWebHostBuilder()	Tworzy element IWebHostBuilder używany do konfigurowania .TestServer
Dispose()	Fabryka rozruchu aplikacji w pamięci na potrzeby testów końcowych funkcjonalnych.
Dispose(Boolean)	Wykonuje zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych.
DisposeAsync()	Fabryka rozruchu aplikacji w pamięci na potrzeby testów końcowych funkcjonalnych.
Finalize()	Finalizuje wystąpienie WebApplicationFactory<TEntryPoint> klasy .
GetTestAssemblies()	Pobiera zestawy zawierające testy funkcjonalne. Zastosowany WebApplicationFactoryContentRootAttribute do tych zestawów definiuje katalog główny zawartości do użycia dla danego TEntryPointelementu .
WithWebHostBuilder(Action<IWebHostBuilder>)	Tworzy nowy WebApplicationFactory<TEntryPoint> element z elementem IWebHostBuilder , który jest dodatkowo dostosowany przez configurationprogram .