WebHostBuilder Classe

Définition

Espace de noms:

Microsoft.AspNetCore.Hosting

Assembly:

Microsoft.AspNetCore.Hosting.dll

Paquet:

Microsoft.AspNetCore.App.Ref v8.0.0

Un générateur pour IWebHost

public ref class WebHostBuilder : Microsoft::AspNetCore::Hosting::IWebHostBuilder

public class WebHostBuilder : Microsoft.AspNetCore.Hosting.IWebHostBuilder

type WebHostBuilder = class
    interface IWebHostBuilder

Public Class WebHostBuilder
Implements IWebHostBuilder

Héritage

Object

WebHostBuilder

Implémente

IWebHostBuilder

Constructeurs

WebHostBuilder()

Initialise une nouvelle instance de la classe WebHostBuilder.

Méthodes

Build()	Génère les services requis et un IWebHost qui héberge une application web.
ConfigureAppConfiguration(Action<WebHostBuilderContext,IConfigurationBuilder>)	Ajoute un délégué pour la configuration de IConfigurationBuilder qui va construire un IConfiguration.
ConfigureServices(Action<IServiceCollection>)	Ajoute un délégué pour configurer des services supplémentaires pour l’application web ou hôte. Peut être appelée plusieurs fois.
ConfigureServices(Action<WebHostBuilderContext,IServiceCollection>)	Ajoute un délégué pour configurer des services supplémentaires pour l’application web ou hôte. Peut être appelée plusieurs fois.
GetSetting(String)	Obtenez la valeur du paramètre à partir de la configuration.
UseSetting(String, String)	Ajoutez ou remplacez un paramètre dans la configuration.

Méthodes d’extension

UseAzureAppServices(IWebHostBuilder)	Configure l’application pour utiliser l’intégration d’Azure AppServices.
CaptureStartupErrors(IWebHostBuilder, Boolean)	Définissez si les erreurs de démarrage doivent être capturées dans les paramètres de configuration de l’hôte web. Lorsque cette option est activée, les exceptions de démarrage sont interceptées et une page d’erreur est retournée. Si cette option est désactivée, les exceptions de démarrage sont propagées.
PreferHostingUrls(IWebHostBuilder, Boolean)	Indiquez si l’hôte doit écouter sur les URL configurées sur le IWebHostBuilder au lieu de celles configurées sur le IServer.
Start(IWebHostBuilder, String[])	Démarrez l’hôte web et écoutez les URL spécifiées.
SuppressStatusMessages(IWebHostBuilder, Boolean)	Spécifiez si les messages status de démarrage doivent être supprimés.
UseConfiguration(IWebHostBuilder, IConfiguration)	Utilisez les paramètres de configuration donnés sur l’hôte web.
UseContentRoot(IWebHostBuilder, String)	Spécifiez le répertoire racine de contenu à utiliser par l’hôte web.
UseEnvironment(IWebHostBuilder, String)	Spécifiez l’environnement à utiliser par l’hôte web.
UseServer(IWebHostBuilder, IServer)	Spécifiez le serveur à utiliser par l’hôte web.
UseShutdownTimeout(IWebHostBuilder, TimeSpan)	Spécifiez la durée d’attente de l’arrêt de l’hôte web.
UseStartup(IWebHostBuilder, String)	Spécifiez l’assembly contenant le type de démarrage à utiliser par l’hôte web.
UseUrls(IWebHostBuilder, String[])	Spécifiez les URL que l’hôte web écoutera.
UseWebRoot(IWebHostBuilder, String)	Spécifiez le répertoire webroot à utiliser par l’hôte web.
ListenHttpOnAnyPort(IWebHostBuilder)	Ajoute le serveur Kestrel instance l’écoute sur le port HTTP donné.
ListenHttpsOnAnyPort(IWebHostBuilder, X509Certificate2)	Ajoute le serveur Kestrel instance l’écoute sur un port HTTPS aléatoire.
UseFakeStartup(IWebHostBuilder)	Ajoute une classe de démarrage vide pour satisfaire ASP.NET case activée.
Configure(IWebHostBuilder, Action<IApplicationBuilder>)	Spécifiez la méthode de démarrage à utiliser pour configurer l’application web.
Configure(IWebHostBuilder, Action<WebHostBuilderContext,IApplicationBuilder>)	Spécifiez la méthode de démarrage à utiliser pour configurer l’application web.
ConfigureAppConfiguration(IWebHostBuilder, Action<IConfigurationBuilder>)	Ajoute un délégué pour la configuration de IConfigurationBuilder qui va construire un IConfiguration.
ConfigureLogging(IWebHostBuilder, Action<WebHostBuilderContext,ILoggingBuilder>)	Ajoute un délégué pour configurer le LoggerFactory fourni. Peut être appelée plusieurs fois.
ConfigureLogging(IWebHostBuilder, Action<ILoggingBuilder>)	Ajoute un délégué pour configurer le ILoggingBuilder fourni. Peut être appelée plusieurs fois.
UseDefaultServiceProvider(IWebHostBuilder, Action<WebHostBuilderContext,ServiceProviderOptions>)	Configure le fournisseur de services par défaut
UseDefaultServiceProvider(IWebHostBuilder, Action<ServiceProviderOptions>)	Configure le fournisseur de services par défaut
UseStartup(IWebHostBuilder, Type)	Spécifiez le type de démarrage à utiliser par l’hôte web.
UseStartup<TStartup>(IWebHostBuilder)	Spécifiez le type de démarrage à utiliser par l’hôte web.
UseStartup<TStartup>(IWebHostBuilder, Func<WebHostBuilderContext,TStartup>)	Spécifiez une fabrique qui crée le instance de démarrage à utiliser par l’hôte web.
UseStaticWebAssets(IWebHostBuilder)	Configure le pour utiliser les ressources web statiques définies par les WebRootFileProvider projets et packages référencés.
UseHttpSys(IWebHostBuilder)	Spécifiez Http.sys comme serveur à utiliser par l’hôte web.
UseHttpSys(IWebHostBuilder, Action<HttpSysOptions>)	Spécifiez Http.sys comme serveur à utiliser par l’hôte web.
UseIIS(IWebHostBuilder)	Configure le port et le chemin d’accès de base que le serveur doit écouter lors de l’exécution derrière AspNetCoreModule. L’application sera également configurée pour capturer les erreurs de démarrage.
UseIISIntegration(IWebHostBuilder)	Configure le port et le chemin d’accès de base que le serveur doit écouter lors de l’exécution derrière AspNetCoreModule. L’application sera également configurée pour capturer les erreurs de démarrage.
ConfigureKestrel(IWebHostBuilder, Action<WebHostBuilderContext,KestrelServerOptions>)	Configure les options Kestrel, mais n’inscrit pas d’IServer. Consultez UseKestrel(IWebHostBuilder).
ConfigureKestrel(IWebHostBuilder, Action<KestrelServerOptions>)	Configure les options Kestrel, mais n’inscrit pas d’IServer. Consultez UseKestrel(IWebHostBuilder).
UseKestrel(IWebHostBuilder)	Spécifiez Kestrel comme serveur à utiliser par l’hôte web.
UseKestrel(IWebHostBuilder, Action<WebHostBuilderContext,KestrelServerOptions>)	Spécifiez Kestrel comme serveur à utiliser par l’hôte web.
UseKestrel(IWebHostBuilder, Action<KestrelServerOptions>)	Spécifiez Kestrel comme serveur à utiliser par l’hôte web.
UseKestrelCore(IWebHostBuilder)	Spécifiez Kestrel comme serveur à utiliser par l’hôte web. Inclut moins de fonctionnalités automatiques que UseKestrel(IWebHostBuilder) pour rendre le découpage plus efficace (par exemple, pour les scénarios AOT natifs ). Si l’hôte finit par dépendre de certaines des fonctionnalités absentes, une tentative optimale sera effectuée pour l’activer à la demande. À défaut, une exception avec un message d’erreur d’information est déclenchée lorsque l’hôte est démarré.
UseKestrelHttpsConfiguration(IWebHostBuilder)	Dans UseKestrelCore(IWebHostBuilder) les scénarios, il peut être nécessaire d’opter explicitement pour certaines fonctionnalités HTTPS. Par exemple, si ASPNETCORE_URLS inclut une https:// adresse, UseKestrelHttpsConfiguration(IWebHostBuilder) active la configuration de HTTPS sur ce point de terminaison. N’a aucun effet dans les UseKestrel(IWebHostBuilder) scénarios.
UseNamedPipes(IWebHostBuilder)	Spécifiez Named Pipes comme transport à utiliser par Kestrel.
UseNamedPipes(IWebHostBuilder, Action<NamedPipeTransportOptions>)	Spécifiez Named Pipes comme transport à utiliser par Kestrel.
UseQuic(IWebHostBuilder)	Spécifiez Quic comme transport à utiliser par Kestrel.
UseQuic(IWebHostBuilder, Action<QuicTransportOptions>)	Spécifiez Quic comme transport à utiliser par Kestrel.
UseSockets(IWebHostBuilder)	Spécifiez Sockets comme transport à utiliser par Kestrel.
UseSockets(IWebHostBuilder, Action<SocketTransportOptions>)	Spécifiez Sockets comme transport à utiliser par Kestrel.
ConfigureTestContainer<TContainer>(IWebHostBuilder, Action<TContainer>)	Configure le IWebHostBuilder instance avec les services fournis dans servicesConfiguration.
ConfigureTestServices(IWebHostBuilder, Action<IServiceCollection>)	Configure le IWebHostBuilder instance avec les services fournis dans servicesConfiguration.
UseSolutionRelativeContentRoot(IWebHostBuilder, String, String)	Définit la racine de contenu de relative à .solutionRelativePath
UseSolutionRelativeContentRoot(IWebHostBuilder, String, String, String)	Définit la racine de contenu de relative à .solutionRelativePath
UseTestServer(IWebHostBuilder)	Active le TestServer service.
UseTestServer(IWebHostBuilder, Action<TestServerOptions>)	Active le TestServer service.