IWebHostBuilder Interface

Définition

Espace de noms:

Microsoft.AspNetCore.Hosting

Assembly:

Microsoft.AspNetCore.Hosting.Abstractions.dll

Paquet:

Microsoft.AspNetCore.App.Ref v8.0.0

Générateur pour IWebHost.

public interface class IWebHostBuilder

public interface IWebHostBuilder

type IWebHostBuilder = interface

Public Interface IWebHostBuilder

Dérivé

Microsoft.AspNetCore.Builder.ConfigureWebHostBuilder

Microsoft.AspNetCore.Hosting.WebHostBuilder

Méthodes

Build()	Génère 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 la configuration de services supplémentaires pour l’hôte ou l’application web. Peut être appelée plusieurs fois.
ConfigureServices(Action<WebHostBuilderContext,IServiceCollection>)	Ajoute un délégué pour la configuration de services supplémentaires pour l’hôte ou l’application web. 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 elle 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 startup 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 pour utiliser des WebRootFileProvider ressources web statiques définies par des 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 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 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 de serveur IServer. Consultez UseKestrel(IWebHostBuilder).
ConfigureKestrel(IWebHostBuilder, Action<KestrelServerOptions>)	Configure les options Kestrel, mais n’inscrit pas de serveur 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, vous pouvez essayer de l’activer à la demande. À défaut, une exception avec un message d’erreur informatif est déclenchée au démarrage de l’hôte.
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 relative à .solutionRelativePath
UseSolutionRelativeContentRoot(IWebHostBuilder, String, String, String)	Définit la racine de contenu relative à .solutionRelativePath
UseTestServer(IWebHostBuilder)	Active le TestServer service.
UseTestServer(IWebHostBuilder, Action<TestServerOptions>)	Active le TestServer service.