WebApplicationFactory<TEntryPoint> Classe

Définition

Espace de noms:

Microsoft.AspNetCore.Mvc.Testing

Assembly:

Microsoft.AspNetCore.Mvc.Testing.dll

Paquet:

Microsoft.AspNetCore.Mvc.Testing v8.0.0

Fabrique pour le démarrage d’une application en mémoire pour les tests fonctionnels de bout en bout.

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

Paramètres de type

TEntryPoint

Type dans l’assembly de point d’entrée de l’application. En règle générale, les classes Startup ou Program peuvent être utilisées.

Héritage

Object

WebApplicationFactory<TEntryPoint>

Implémente

IDisposable IAsyncDisposable

Constructeurs

WebApplicationFactory<TEntryPoint>()

Crée une instance de WebApplicationFactory<TEntryPoint>. Cette fabrique peut être utilisée pour créer un TestServer instance à l’aide de l’application MVC définie par TEntryPoint et d’une ou plusieurs HttpClient instances utilisées pour envoyer HttpRequestMessage à .TestServer WebApplicationFactory<TEntryPoint> recherche la classe de point d’entrée de l’assembly TEntryPoint et initialise l’application en appelant IWebHostBuilder CreateWebHostBuilder(string [] args) sur TEntryPoint. Ce constructeur déduit le chemin racine du contenu de l’application en recherchant un WebApplicationFactoryContentRootAttribute sur l’assembly contenant les tests fonctionnels avec une clé égale à l’assembly TEntryPointFullName. Si un attribut avec la clé droite est introuvable, WebApplicationFactory<TEntryPoint> vous revenez à la recherche d’un fichier de solution (*.sln), puis à l’ajout TEntryPoint du nom de l’assembly au répertoire de solution. Le répertoire racine de l’application sera utilisé pour découvrir les vues et les fichiers de contenu. Les assemblys d’application seront chargés à partir du contexte de dépendance de l’assembly contenant TEntryPoint. Cela signifie que les dépendances de projet de l’assembly contenant TEntryPoint seront chargées en tant qu’assemblys d’application.

Propriétés

ClientOptions	Obtient le WebApplicationFactoryClientOptions utilisé par CreateClient().
Factories	Obtient le IReadOnlyList<T> des fabriques créées à partir de cette fabrique en personnalisant davantage lors de l’appel IWebHostBuilderWithWebHostBuilder(Action<IWebHostBuilder>)de .
Server	Obtient le TestServer créé par ce WebApplicationFactory<TEntryPoint>.
Services	Obtient le IServiceProvider créé par le serveur associé à ce WebApplicationFactory<TEntryPoint>.

Méthodes

ConfigureClient(HttpClient)	Configure les instances créées HttpClient par ce WebApplicationFactory<TEntryPoint>.
ConfigureWebHost(IWebHostBuilder)	Donne à un montage la possibilité de configurer l’application avant sa génération.
CreateClient()	Crée un instance de HttpClient qui suit automatiquement les redirections et gère les cookies.
CreateClient(WebApplicationFactoryClientOptions)	Crée un instance de HttpClient qui suit automatiquement les redirections et gère les cookies.
CreateDefaultClient(DelegatingHandler[])	Crée un instance d’un HttpClient qui peut être utilisé pour envoyer HttpRequestMessage au serveur. L’adresse de base du HttpClient instance est définie sur http://localhost.
CreateDefaultClient(Uri, DelegatingHandler[])	Crée un instance d’un HttpClient qui peut être utilisé pour envoyer HttpRequestMessage au serveur.
CreateHost(IHostBuilder)	Crée le IHost avec l’application de démarrage dans builder. Ceci est uniquement appelé pour les applications qui utilisent IHostBuilder. Les applications basées sur IWebHostBuilder utiliseront CreateServer(IWebHostBuilder) à la place.
CreateHostBuilder()	Crée un IHostBuilder utilisé pour configurer TestServer.
CreateServer(IWebHostBuilder)	Crée le TestServer avec l’application de démarrage dans builder. Ceci est uniquement appelé pour les applications qui utilisent IWebHostBuilder. Les applications basées sur IHostBuilder utiliseront CreateHost(IHostBuilder) à la place.
CreateWebHostBuilder()	Crée un IWebHostBuilder utilisé pour configurer TestServer.
Dispose()	Fabrique pour le démarrage d’une application en mémoire pour les tests fonctionnels de bout en bout.
Dispose(Boolean)	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.
DisposeAsync()	Fabrique pour le démarrage d’une application en mémoire pour les tests fonctionnels de bout en bout.
Finalize()	Finalise un instance de la WebApplicationFactory<TEntryPoint> classe.
GetTestAssemblies()	Obtient les assemblys contenant les tests fonctionnels. Le WebApplicationFactoryContentRootAttribute appliqué à ces assemblys définit la racine de contenu à utiliser pour le donné TEntryPoint.
WithWebHostBuilder(Action<IWebHostBuilder>)	Crée un nouveau WebApplicationFactory<TEntryPoint> avec un IWebHostBuilder qui est davantage personnalisé par configuration.