IApplicationBuilder Interface

Définition

Espace de noms:

Microsoft.AspNetCore.Builder

Assembly:

Microsoft.AspNetCore.Http.Abstractions.dll

Paquet:

Microsoft.AspNetCore.App.Ref v8.0.0

Définit une classe qui fournit les mécanismes permettant de configurer le pipeline de requête d’une application.

public interface class IApplicationBuilder

public interface IApplicationBuilder

type IApplicationBuilder = interface

Public Interface IApplicationBuilder

Dérivé

Microsoft.AspNetCore.Builder.ApplicationBuilder

Microsoft.AspNetCore.Builder.WebApplication

Microsoft.AspNetCore.MiddlewareAnalysis.AnalysisBuilder

Propriétés

ApplicationServices	Obtient ou définit le IServiceProvider qui fournit l’accès au conteneur de service de l’application.
Properties	Obtient une collection clé/valeur qui peut être utilisée pour partager des données entre intergiciels.
ServerFeatures	Obtient l’ensemble des fonctionnalités HTTP fournies par le serveur de l’application.

Méthodes

Build()	Génère le délégué utilisé par cette application pour traiter les requêtes HTTP.
New()	Crée un nouveau IApplicationBuilder qui partage le Properties de ce IApplicationBuilder.
Use(Func<RequestDelegate,RequestDelegate>)	Ajoute un délégué middleware au pipeline de requête de l’application.

Méthodes d’extension

UseAntiforgery(IApplicationBuilder)	Ajoute l’intergiciel anti-falsification au pipeline.
UseRequestLocalization(IApplicationBuilder)	Ajoute à RequestLocalizationMiddleware pour définir automatiquement les informations de culture pour les demandes en fonction des informations fournies par le client.
UseRequestLocalization(IApplicationBuilder, RequestLocalizationOptions)	Ajoute à RequestLocalizationMiddleware pour définir automatiquement les informations de culture pour les demandes en fonction des informations fournies par le client.
UseRequestLocalization(IApplicationBuilder, Action<RequestLocalizationOptions>)	Ajoute à RequestLocalizationMiddleware pour définir automatiquement les informations de culture pour les demandes en fonction des informations fournies par le client.
UseRequestLocalization(IApplicationBuilder, String[])	Ajoute à RequestLocalizationMiddleware pour définir automatiquement les informations de culture pour les demandes en fonction des informations fournies par le client.
UseAuthentication(IApplicationBuilder)	Ajoute au AuthenticationMiddleware spécifié IApplicationBuilder, ce qui active les fonctionnalités d’authentification.
UseAuthorization(IApplicationBuilder)	Ajoute au AuthorizationMiddleware spécifié IApplicationBuilder, ce qui active les fonctionnalités d’autorisation. Lors de l’autorisation d’une ressource routée à l’aide du routage de point de terminaison, cet appel doit apparaître entre les appels à app.UseRouting() et app.UseEndpoints(...) pour que le middleware fonctionne correctement.
UseCertificateForwarding(IApplicationBuilder)	Ajoute un intergiciel au pipeline qui recherche un certificat dans un en-tête de requête le décodent et met à jour HttpContext.Connection.ClientCertificate.
UseBlazorFrameworkFiles(IApplicationBuilder)	Configure l’application pour traiter les fichiers d’infrastructure Blazor WebAssembly à partir du chemin racine « / ».
UseBlazorFrameworkFiles(IApplicationBuilder, PathString)	Configure l’application pour servir les fichiers d’infrastructure Blazor WebAssembly à partir du chemin d’accès pathPrefix. Ce chemin doit correspondre à un projet d’application Blazor WebAssembly référencé.
UseConcurrencyLimiter(IApplicationBuilder)	Obsolète. Ajoute le ConcurrencyLimiterMiddleware pour limiter le nombre de requêtes exécutées simultanément.
UseCookiePolicy(IApplicationBuilder)	Ajoute le CookiePolicyMiddleware gestionnaire au spécifié IApplicationBuilder, ce qui active les fonctionnalités de stratégie de cookies.
UseCookiePolicy(IApplicationBuilder, CookiePolicyOptions)	Ajoute le CookiePolicyMiddleware gestionnaire au spécifié IApplicationBuilder, ce qui active les fonctionnalités de stratégie de cookies.
UseCors(IApplicationBuilder)	Ajoute un intergiciel (middleware) CORS au pipeline de votre application web pour autoriser les demandes entre les domaines.
UseCors(IApplicationBuilder, Action<CorsPolicyBuilder>)	Ajoute un intergiciel (middleware) CORS au pipeline de votre application web pour autoriser les demandes entre les domaines.
UseCors(IApplicationBuilder, String)	Ajoute un intergiciel (middleware) CORS au pipeline de votre application web pour autoriser les demandes entre les domaines.
UseDatabaseErrorPage(IApplicationBuilder)	Obsolète. Capture les exceptions synchrones et asynchrones liées à la base de données du pipeline qui peuvent être résolues à l’aide de migrations Entity Framework. Lorsque ces exceptions se produisent, une réponse HTML comportant le détail des actions possibles pour résoudre le problème est générée.
UseDatabaseErrorPage(IApplicationBuilder, DatabaseErrorPageOptions)	Obsolète. Capture les exceptions synchrones et asynchrones liées à la base de données du pipeline qui peuvent être résolues à l’aide de migrations Entity Framework. Lorsque ces exceptions se produisent, une réponse HTML comportant le détail des actions possibles pour résoudre le problème est générée.
UseDefaultFiles(IApplicationBuilder)	Active le mappage de fichiers par défaut sur le chemin d’accès actuel
UseDefaultFiles(IApplicationBuilder, DefaultFilesOptions)	Active le mappage de fichiers par défaut avec les options spécifiées.
UseDefaultFiles(IApplicationBuilder, String)	Active le mappage de fichiers par défaut pour le chemin de requête donné
UseDeveloperExceptionPage(IApplicationBuilder)	Capture des instances synchrones et asynchrones Exception à partir du pipeline et génère des réponses d’erreur HTML.
UseDeveloperExceptionPage(IApplicationBuilder, DeveloperExceptionPageOptions)	Capture des instances synchrones et asynchrones Exception à partir du pipeline et génère des réponses d’erreur HTML.
UseDirectoryBrowser(IApplicationBuilder)	Activer la navigation dans les répertoires sur le chemin d’accès actuel
UseDirectoryBrowser(IApplicationBuilder, DirectoryBrowserOptions)	Active l'exploration de répertoire avec les options spécifiées.
UseDirectoryBrowser(IApplicationBuilder, String)	Active la navigation dans le répertoire pour le chemin d’accès de la requête donné
UseEndpoints(IApplicationBuilder, Action<IEndpointRouteBuilder>)	Ajoute un Microsoft.AspNetCore.Routing.EndpointMiddleware intergiciel au spécifié avec les EndpointDataSource instances générées IApplicationBuilder à partir de configuré IEndpointRouteBuilder. Microsoft.AspNetCore.Routing.EndpointMiddleware exécute le Endpoint associé à la demande actuelle.
UseRouting(IApplicationBuilder)	Ajoute un Microsoft.AspNetCore.Routing.EndpointRoutingMiddleware intergiciel au spécifié IApplicationBuilder.
UseExceptionHandler(IApplicationBuilder)	Ajoute un intergiciel au pipeline qui intercepte les exceptions, les journalise et réexécute la demande dans un autre pipeline. La demande ne sera pas réexécutaée si la réponse a déjà démarré.
UseExceptionHandler(IApplicationBuilder, ExceptionHandlerOptions)	Ajoute un intergiciel au pipeline qui intercepte les exceptions, les journalise et réexécute la demande dans un autre pipeline. La demande ne sera pas réexécutaée si la réponse a déjà démarré.
UseExceptionHandler(IApplicationBuilder, Action<IApplicationBuilder>)	Ajoute un intergiciel au pipeline qui intercepte les exceptions, les journalise et réexécute la demande dans un autre pipeline. La demande ne sera pas réexécutaée si la réponse a déjà démarré.
UseExceptionHandler(IApplicationBuilder, String)	Ajoute un intergiciel au pipeline qui intercepte les exceptions, les journalise, réinitialise le chemin de la requête et réexécute la demande. La demande ne sera pas réexécutaée si la réponse a déjà démarré.
UseExceptionHandler(IApplicationBuilder, String, Boolean)	Ajoute un intergiciel au pipeline qui intercepte les exceptions, les journalise, réinitialise le chemin de la requête et réexécute la demande. La demande ne sera pas réexécutaée si la réponse a déjà démarré.
UseFileServer(IApplicationBuilder)	Active tous les composants d'intergiciel (middleware) de fichiers statiques (sauf l'exploration de répertoires) pour le chemin d'accès de la demande actuelle dans le répertoire actif.
UseFileServer(IApplicationBuilder, FileServerOptions)	Active tous les composants d'intergiciel (middleware) de fichiers statiques avec les options spécifiées.
UseFileServer(IApplicationBuilder, Boolean)	Active tous les composants d'intergiciel (middleware) de fichiers statiques pour le chemin d'accès de la demande actuelle dans le répertoire actif.
UseFileServer(IApplicationBuilder, String)	Active tous les composants d'intergiciel (middleware) de fichiers statiques (sauf l'exploration de répertoires) pour le chemin d'accès de la demande actuelle à partir du répertoire du même nom.
UseForwardedHeaders(IApplicationBuilder)	Applique les en-têtes transférés à leurs champs correspondants sur la demande actuelle. Par convention, les proxys HTTP transfèrent les informations du client dans des en-têtes HTTP connus. le ForwardedHeadersMiddleware lit ces en-têtes et remplit les champs associés sur HttpContext.
UseForwardedHeaders(IApplicationBuilder, ForwardedHeadersOptions)	Applique les en-têtes transférés à leurs champs correspondants sur la demande actuelle. Par convention, les proxys HTTP transfèrent les informations du client dans des en-têtes HTTP connus. le ForwardedHeadersMiddleware lit ces en-têtes et remplit les champs associés sur HttpContext.
UseHeaderPropagation(IApplicationBuilder)	Ajoute un intergiciel qui collecte les en-têtes à propager à un HttpClient.
UseHealthChecks(IApplicationBuilder, PathString)	Ajoute un intergiciel (middleware) qui fournit des case activée status d’intégrité.
UseHealthChecks(IApplicationBuilder, PathString, HealthCheckOptions)	Ajoute un intergiciel (middleware) qui fournit des case activée status d’intégrité.
UseHealthChecks(IApplicationBuilder, PathString, Int32)	Ajoute un intergiciel (middleware) qui fournit des case activée status d’intégrité.
UseHealthChecks(IApplicationBuilder, PathString, Int32, HealthCheckOptions)	Ajoute un intergiciel (middleware) qui fournit des case activée status d’intégrité.
UseHealthChecks(IApplicationBuilder, PathString, String)	Ajoute un intergiciel (middleware) qui fournit des case activée status d’intégrité.
UseHealthChecks(IApplicationBuilder, PathString, String, HealthCheckOptions)	Ajoute un intergiciel (middleware) qui fournit des case activée status d’intégrité.
UseHostFiltering(IApplicationBuilder)	Ajoute un intergiciel pour filtrer les demandes par en-têtes d’hôte autorisés. Les demandes non valides seront rejetées avec un code de 400 status.
UseHsts(IApplicationBuilder)	Ajoute un intergiciel pour l’utilisation de HSTS, ce qui ajoute l’en-tête Strict-Transport-Security.
UseHttpLogging(IApplicationBuilder)	Ajoute un intergiciel qui peut journaliser les requêtes et les réponses HTTP.
UseW3CLogging(IApplicationBuilder)	Ajoute un intergiciel qui peut journaliser les requêtes et réponses HTTP pour les journaux de serveur au format W3C.
UseHttpMethodOverride(IApplicationBuilder)	Permet à la requête POST entrante de remplacer le type de méthode avec le type spécifié dans l’en-tête. Ce middleware est utilisé lorsqu’un client se limite à l’envoi de méthodes GET ou POST, mais souhaite appeler d’autres méthodes HTTP. Par défaut, l’en-tête de requête X-HTTP-Method-Override est utilisé pour spécifier la méthode HTTP en cours de tunnel.
UseHttpMethodOverride(IApplicationBuilder, HttpMethodOverrideOptions)	Permet à la requête POST entrante de remplacer le type de méthode par le type spécifié dans le formulaire. Ce middleware est utilisé lorsqu’un client se limite à l’envoi de méthodes GET ou POST, mais souhaite appeler d’autres méthodes HTTP.
UseHttpsRedirection(IApplicationBuilder)	Ajoute un intergiciel pour rediriger les requêtes HTTP vers HTTPS.
Map(IApplicationBuilder, PathString, Action<IApplicationBuilder>)	Branche le pipeline de requête en fonction des correspondances du chemin de requête donné. Si le chemin de requête commence par le chemin donné, la branche est exécutée.
Map(IApplicationBuilder, PathString, Boolean, Action<IApplicationBuilder>)	Branche le pipeline de requête en fonction des correspondances du chemin de requête donné. Si le chemin de requête commence par le chemin donné, la branche est exécutée.
Map(IApplicationBuilder, String, Action<IApplicationBuilder>)	Branche le pipeline de requête en fonction des correspondances du chemin de requête donné. Si le chemin de requête commence par le chemin donné, la branche est exécutée.
MapWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Branche le pipeline de requêtes en fonction du résultat du prédicat donné.
UseMigrationsEndPoint(IApplicationBuilder)	Traite les demandes d’exécution d’opérations de migration. L’intergiciel écoutera les requêtes adressées à DefaultPath.
UseMigrationsEndPoint(IApplicationBuilder, MigrationsEndPointOptions)	Traite les demandes d’exécution d’opérations de migration. L’intergiciel (middleware) écoute les demandes adressées au chemin configuré dans options.
UseMvc(IApplicationBuilder)	Ajoute MVC au pipeline d’exécution de la IApplicationBuilder requête.
UseMvc(IApplicationBuilder, Action<IRouteBuilder>)	Ajoute MVC au pipeline d’exécution de la IApplicationBuilder requête.
UseMvcWithDefaultRoute(IApplicationBuilder)	Ajoute MVC au pipeline d’exécution de la IApplicationBuilder demande avec un itinéraire par défaut nommé « default » et le modèle suivant : « {controller=Home}/{action=Index}/{id ?} ».
UseOutputCache(IApplicationBuilder)	Définit une classe qui fournit les mécanismes permettant de configurer le pipeline de requête d’une application.
UseOwin(IApplicationBuilder)	Ajoute un pipeline OWIN au spécifié IApplicationBuilder.
UseOwin(IApplicationBuilder, Action<Action<Func<Func<IDictionary<String,Object>,Task>,Func<IDictionary<String,Object>,Task>>>>)	Ajoute le pipeline de middleware OWIN au spécifié IApplicationBuilder.
UseRateLimiter(IApplicationBuilder)	Active la limitation du débit pour l’application.
UseRateLimiter(IApplicationBuilder, RateLimiterOptions)	Active la limitation du débit pour l’application.
UseRequestDecompression(IApplicationBuilder)	Ajoute un intergiciel pour la décompression dynamique des corps de requêtes HTTP.
UseRequestTimeouts(IApplicationBuilder)	Active les délais d’expiration des demandes pour l’application. Aucun délai d’attente n’est configuré par défaut. Ils doivent être configurés dans RequestTimeoutOptions, sur RequestTimeoutAttribute les points de terminaison ou à l’aide des extensions de routage WithRequestTimeout.
UseResponseCaching(IApplicationBuilder)	Ajoute le ResponseCachingMiddleware pour la mise en cache des réponses HTTP.
UseResponseCompression(IApplicationBuilder)	Ajoute un intergiciel pour compresser dynamiquement les réponses HTTP.
UseRewriter(IApplicationBuilder)	Vérifie si une URL donnée correspond à des règles et des conditions, et modifie httpContext sur correspondance.
UseRewriter(IApplicationBuilder, RewriteOptions)	Vérifie si une URL donnée correspond à des règles et des conditions, et modifie httpContext sur correspondance.
UseRouter(IApplicationBuilder, IRouter)	Ajoute un RouterMiddleware intergiciel au spécifié IApplicationBuilder avec le spécifié IRouter.
UseRouter(IApplicationBuilder, Action<IRouteBuilder>)	Ajoute un RouterMiddleware intergiciel au spécifié IApplicationBuilder avec le IRouter généré à partir de configuré IRouteBuilder.
Run(IApplicationBuilder, RequestDelegate)	Ajoute un délégué d’intergiciels de terminal au pipeline de requête de l’application.
UseSession(IApplicationBuilder)	Ajoute le SessionMiddleware pour activer automatiquement l’état de session pour l’application.
UseSession(IApplicationBuilder, SessionOptions)	Ajoute le SessionMiddleware pour activer automatiquement l’état de session pour l’application.
UseSpa(IApplicationBuilder, Action<ISpaBuilder>)	Gère toutes les demandes à partir de ce point dans la chaîne d’intergiciels en retournant la page par défaut de l’application monopage (SPA). Ce middleware doit être placé tardivement dans la chaîne, de sorte que d’autres middlewares pour la distribution de fichiers statiques, d’actions MVC, etc., soient prioritaires.
UseStaticFiles(IApplicationBuilder)	Active la distribution de fichiers statiques pour le chemin d’accès de la requête actuelle
UseStaticFiles(IApplicationBuilder, StaticFileOptions)	Active l'utilisation de fichiers statiques avec les options spécifiées.
UseStaticFiles(IApplicationBuilder, String)	Active la distribution de fichiers statiques pour le chemin de requête donné
UseStatusCodePages(IApplicationBuilder)	Ajoute un intergiciel StatusCodePages avec un gestionnaire de réponses par défaut qui recherche les réponses avec des codes status compris entre 400 et 599 qui n’ont pas de corps.
UseStatusCodePages(IApplicationBuilder, StatusCodePagesOptions)	Ajoute un intergiciel StatusCodePages avec les options fournies qui recherche les réponses avec des codes status compris entre 400 et 599 qui n’ont pas de corps.
UseStatusCodePages(IApplicationBuilder, Action<IApplicationBuilder>)	Ajoute un middleware StatusCodePages au pipeline avec le pipeline d’intergiciel de remplacement spécifié à exécuter pour générer le corps de la réponse.
UseStatusCodePages(IApplicationBuilder, Func<StatusCodeContext,Task>)	Ajoute un intergiciel StatusCodePages avec le gestionnaire spécifié qui recherche les réponses avec des codes status compris entre 400 et 599 qui n’ont pas de corps.
UseStatusCodePages(IApplicationBuilder, String, String)	Ajoute un intergiciel StatusCodePages avec le corps de réponse spécifié à envoyer. Cela peut inclure un espace réservé «{0} » pour le code status. Le middleware recherche les réponses avec des codes status compris entre 400 et 599 qui n’ont pas de corps.
UseStatusCodePagesWithRedirects(IApplicationBuilder, String)	Ajoute un intergiciel StatusCodePages au pipeline. Spécifie que les réponses doivent être gérées en redirigeant avec le modèle d’URL d’emplacement donné. Cela peut inclure un espace réservé «{0} » pour le code status. Les URL commençant par « ~ » auront PathBase prérempli, où toute autre URL sera utilisée telle quelle.
UseStatusCodePagesWithReExecute(IApplicationBuilder, String, String)	Ajoute un intergiciel StatusCodePages au pipeline. Indique que le corps de la réponse doit être généré en réexécutant le pipeline de requête avec un autre chemin. Ce chemin d’accès peut contenir un espace réservé «{0} » du code status.
Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>)	Ajoute un délégué middleware défini en ligne au pipeline de requête de l’application. Si vous n’appelez pas la fonction suivante, utilisez Run(IApplicationBuilder, RequestDelegate) à la place.
Use(IApplicationBuilder, Func<HttpContext,Func<Task>,Task>)	Ajoute un délégué middleware défini en ligne au pipeline de requête de l’application. Si vous n’appelez pas la fonction suivante, utilisez Run(IApplicationBuilder, RequestDelegate) à la place. Préférez utiliser Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>) pour de meilleures performances, comme indiqué ci-dessous : app.Use((context, next) => { return next(context); });
UseMiddleware(IApplicationBuilder, Type, Object[])	Ajoute un type de middleware au pipeline de requête de l’application.
UseMiddleware<TMiddleware>(IApplicationBuilder, Object[])	Ajoute un type de middleware au pipeline de requête de l’application.
UsePathBase(IApplicationBuilder, PathString)	Ajoute un middleware qui extrait la base de chemin d’accès spécifiée du chemin d’accès de la requête et la postpendez à la base de chemin d’accès de la requête.
UseWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Crée de manière conditionnelle une branche dans le pipeline de requête qui est jointe au pipeline main.
UseWebAssemblyDebugging(IApplicationBuilder)	Ajoute un intergiciel nécessaire pour le débogage d’applications Blazor WebAssembly à l’intérieur Chromium outils de développement.
UseWebSockets(IApplicationBuilder)	Ajoute au WebSocketMiddleware pipeline de requête.
UseWebSockets(IApplicationBuilder, WebSocketOptions)	Ajoute au WebSocketMiddleware pipeline de requête.
UseWelcomePage(IApplicationBuilder)	Ajoute WelcomePageMiddleware au pipeline.
UseWelcomePage(IApplicationBuilder, WelcomePageOptions)	Ajoute WelcomePageMiddleware au pipeline avec les options spécifiées.
UseWelcomePage(IApplicationBuilder, PathString)	Ajoute WelcomePageMiddleware au pipeline avec le chemin d'accès donné.
UseWelcomePage(IApplicationBuilder, String)	Ajoute WelcomePageMiddleware au pipeline avec le chemin d'accès donné.
UseHttpLoggingMiddleware(IApplicationBuilder)	Inscrit le middleware de journalisation des requêtes HTTP entrantes dans IApplicationBuilder.
UseRequestCheckpoint(IApplicationBuilder)	Inscrit les intergiciels liés au point de contrôle de demande dans le pipeline.
UseRequestLatencyTelemetry(IApplicationBuilder)	Ajoute le middleware de télémétrie à latence des requêtes au pipeline d’exécution IApplicationBuilder de la demande.
UseSpaStaticFiles(IApplicationBuilder)	Configure l’application pour qu’elle serve des fichiers statiques pour une application monopage (SPA). Les fichiers seront localisés à l’aide du service inscrit ISpaStaticFileProvider .
UseSpaStaticFiles(IApplicationBuilder, StaticFileOptions)	Configure l’application pour qu’elle serve des fichiers statiques pour une application monopage (SPA). Les fichiers seront localisés à l’aide du service inscrit ISpaStaticFileProvider .