IApplicationBuilder Interface

Définition

Espace de noms:

Microsoft.AspNetCore.Builder

Assembly:

Microsoft.AspNetCore.Http.Abstractions.dll

Paquet:

Microsoft.AspNetCore.App.Ref v8.0.0

Source:

IApplicationBuilder.cs

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 une IApplicationBuilder qui partage la Properties de cette 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 le RequestLocalizationMiddleware pour définir automatiquement des informations de culture pour les demandes en fonction des informations fournies par le client.
UseRequestLocalization(IApplicationBuilder, RequestLocalizationOptions)	Ajoute le RequestLocalizationMiddleware pour définir automatiquement des informations de culture pour les demandes en fonction des informations fournies par le client.
UseRequestLocalization(IApplicationBuilder, Action<RequestLocalizationOptions>)	Ajoute le RequestLocalizationMiddleware pour définir automatiquement des informations de culture pour les demandes en fonction des informations fournies par le client.
UseRequestLocalization(IApplicationBuilder, String[])	Ajoute le RequestLocalizationMiddleware pour définir automatiquement des informations de culture pour les demandes en fonction des informations fournies par le client.
UseAuthentication(IApplicationBuilder)	Ajoute le AuthenticationMiddleware au IApplicationBuilderspécifié, qui active les fonctionnalités d’authentification.
UseAuthorization(IApplicationBuilder)	Ajoute le AuthorizationMiddleware au IApplicationBuilderspécifié, 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 l’intergiciel fonctionne correctement.
UseCertificateForwarding(IApplicationBuilder)	Ajoute un intergiciel au pipeline qui recherche un certificat dans un en-tête de requête le décodage et met à jour HttpContext.Connection.ClientCertificate.
UseBlazorFrameworkFiles(IApplicationBuilder)	Configure l’application pour traiter les fichiers d’infrastructure Blazor WebAssembly à partir du chemin d’accès racine « / ».
UseBlazorFrameworkFiles(IApplicationBuilder, PathString)	Configure l’application pour traiter 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 la ConcurrencyLimiterMiddleware pour limiter le nombre de requêtes en cours d’exécution simultanée.
UseCookiePolicy(IApplicationBuilder)	Ajoute le gestionnaire CookiePolicyMiddleware au IApplicationBuilderspécifié, qui active les fonctionnalités de stratégie de cookie.
UseCookiePolicy(IApplicationBuilder, CookiePolicyOptions)	Ajoute le gestionnaire CookiePolicyMiddleware au IApplicationBuilderspécifié, qui active les fonctionnalités de stratégie de cookie.
UseCors(IApplicationBuilder)	Ajoute un intergiciel CORS à votre pipeline d’application web pour autoriser les requêtes inter-domaines.
UseCors(IApplicationBuilder, Action<CorsPolicyBuilder>)	Ajoute un intergiciel CORS à votre pipeline d’application web pour autoriser les requêtes inter-domaines.
UseCors(IApplicationBuilder, String)	Ajoute un intergiciel CORS à votre pipeline d’application web pour autoriser les requêtes inter-domaines.
UseDatabaseErrorPage(IApplicationBuilder)	Obsolète. Capture les exceptions de base de données synchrones et asynchrones du pipeline qui peuvent être résolues à l’aide de migrations Entity Framework. Lorsque ces exceptions se produisent, une réponse HTML contenant des détails sur les actions possibles pour résoudre le problème est générée.
UseDatabaseErrorPage(IApplicationBuilder, DatabaseErrorPageOptions)	Obsolète. Capture les exceptions de base de données synchrones et asynchrones du pipeline qui peuvent être résolues à l’aide de migrations Entity Framework. Lorsque ces exceptions se produisent, une réponse HTML contenant des détails sur les 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 données
UseDefaultFiles(IApplicationBuilder, String)	Active le mappage de fichiers par défaut pour le chemin de requête donné
UseDeveloperExceptionPage(IApplicationBuilder)	Capture des instances de Exception synchrones et asynchrones à partir du pipeline et génère des réponses d’erreur HTML.
UseDeveloperExceptionPage(IApplicationBuilder, DeveloperExceptionPageOptions)	Capture des instances de Exception synchrones et asynchrones à partir du pipeline et génère des réponses d’erreur HTML.
UseDirectoryBrowser(IApplicationBuilder)	Activer la navigation dans le répertoire sur le chemin d’accès actuel
UseDirectoryBrowser(IApplicationBuilder, DirectoryBrowserOptions)	Activer la navigation dans le répertoire avec les options données
UseDirectoryBrowser(IApplicationBuilder, String)	Active la navigation dans le répertoire pour le chemin de requête donné
UseEndpoints(IApplicationBuilder, Action<IEndpointRouteBuilder>)	Ajoute un intergiciel Microsoft.AspNetCore.Routing.EndpointMiddleware au IApplicationBuilder spécifié avec les instances de EndpointDataSource générées à partir de IEndpointRouteBuilderconfigurées. La Microsoft.AspNetCore.Routing.EndpointMiddleware exécutera la Endpoint associée à la requête actuelle.
UseRouting(IApplicationBuilder)	Ajoute un intergiciel Microsoft.AspNetCore.Routing.EndpointRoutingMiddleware au IApplicationBuilderspécifié.
UseExceptionHandler(IApplicationBuilder)	Ajoute un intergiciel au pipeline qui intercepte les exceptions, les journalise et réexécute la requête dans un autre pipeline. La requête ne sera pas réexécuté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 requête dans un autre pipeline. La requête ne sera pas réexécuté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 requête dans un autre pipeline. La requête ne sera pas réexécuté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 requête. La requête ne sera pas réexécuté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 requête. La requête ne sera pas réexécutée si la réponse a déjà démarré.
UseFileServer(IApplicationBuilder)	Activez tous les intergiciels de fichiers statiques (à l’exception de la navigation dans le répertoire) pour le chemin de requête actuel dans le répertoire actif.
UseFileServer(IApplicationBuilder, FileServerOptions)	Activer tous les intergiciels de fichiers statiques avec les options données
UseFileServer(IApplicationBuilder, Boolean)	Activez tous les intergiciels de fichiers statiques pour le chemin de requête actuel dans le répertoire actif.
UseFileServer(IApplicationBuilder, String)	Active tous les intergiciels de fichiers statiques (à l’exception de la navigation dans le répertoire) pour le chemin de requête donné à partir du répertoire du même nom
UseForwardedHeaders(IApplicationBuilder)	Applique les en-têtes transférés à leurs champs correspondants sur la requête actuelle. Par convention, les proxys HTTP transfèrent les informations du client dans les en-têtes HTTP connus. Le ForwardedHeadersMiddleware lit ces en-têtes et renseigne les champs associés sur HttpContext.
UseForwardedHeaders(IApplicationBuilder, ForwardedHeadersOptions)	Applique les en-têtes transférés à leurs champs correspondants sur la requête actuelle. Par convention, les proxys HTTP transfèrent les informations du client dans les en-têtes HTTP connus. Le ForwardedHeadersMiddleware lit ces en-têtes et renseigne 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 qui fournit l’état de contrôle d’intégrité.
UseHealthChecks(IApplicationBuilder, PathString, HealthCheckOptions)	Ajoute un intergiciel qui fournit l’état de contrôle d’intégrité.
UseHealthChecks(IApplicationBuilder, PathString, Int32)	Ajoute un intergiciel qui fournit l’état de contrôle d’intégrité.
UseHealthChecks(IApplicationBuilder, PathString, Int32, HealthCheckOptions)	Ajoute un intergiciel qui fournit l’état de contrôle d’intégrité.
UseHealthChecks(IApplicationBuilder, PathString, String)	Ajoute un intergiciel qui fournit l’état de contrôle d’intégrité.
UseHealthChecks(IApplicationBuilder, PathString, String, HealthCheckOptions)	Ajoute un intergiciel qui fournit l’état de contrôle d’intégrité.
UseHostFiltering(IApplicationBuilder)	Ajoute un intergiciel pour le filtrage des demandes par en-têtes d’hôte autorisés. Les demandes non valides sont rejetées avec un code d’état 400.
UseHsts(IApplicationBuilder)	Ajoute un intergiciel pour l’utilisation de HSTS, qui ajoute l’en-tête Strict-Transport-Security.
UseHttpLogging(IApplicationBuilder)	Ajoute un intergiciel qui peut consigner les requêtes et réponses HTTP.
UseW3CLogging(IApplicationBuilder)	Ajoute un intergiciel qui peut consigner 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 par le type spécifié dans l’en-tête. Cet intergiciel est utilisé lorsqu’un client est limité à l’envoi de méthodes GET ou POST, mais qu’il 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é sous forme. Cet intergiciel est utilisé lorsqu’un client est limité à l’envoi de méthodes GET ou POST, mais qu’il 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ête en fonction du résultat du prédicat donné.
UseMigrationsEndPoint(IApplicationBuilder)	Traite les demandes d’exécution des opérations de migration. L’intergiciel écoute les demandes adressées à DefaultPath.
UseMigrationsEndPoint(IApplicationBuilder, MigrationsEndPointOptions)	Traite les demandes d’exécution des opérations de migration. L’intergiciel écoute les demandes adressées au chemin d’accès configuré dans options.
UseMvc(IApplicationBuilder)	Ajoute MVC au pipeline d’exécution de requête IApplicationBuilder.
UseMvc(IApplicationBuilder, Action<IRouteBuilder>)	Ajoute MVC au pipeline d’exécution de requête IApplicationBuilder.
UseMvcWithDefaultRoute(IApplicationBuilder)	Ajoute MVC au pipeline d’exécution de requête IApplicationBuilder avec un itinéraire par défaut nommé « default » et le modèle suivant : « {controller=Home}/{action=Index}/{id ?} ».
UseOutputCache(IApplicationBuilder)	Ajoute la Microsoft.AspNetCore.OutputCaching.OutputCacheMiddleware pour mettre en cache les réponses HTTP.
UseOwin(IApplicationBuilder)	Ajoute un pipeline OWIN au IApplicationBuilderspécifié.
UseOwin(IApplicationBuilder, Action<Action<Func<Func<IDictionary<String,Object>,Task>,Func<IDictionary<String,Object>,Task>>>>)	Ajoute le pipeline d’intergiciel OWIN au IApplicationBuilderspécifié.
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 décompresser dynamiquement les corps de requête HTTP.
UseRequestTimeouts(IApplicationBuilder)	Active les délais d’expiration des demandes pour l’application. Aucun délai d’expiration n’est configuré par défaut. Ils doivent être configurés dans RequestTimeoutOptions, les RequestTimeoutAttribute sur les points de terminaison ou à l’aide des extensions de routage WithRequestTimeout.
UseResponseCaching(IApplicationBuilder)	Ajoute la ResponseCachingMiddleware pour mettre en cache les 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 le httpContext lors de la correspondance.
UseRewriter(IApplicationBuilder, RewriteOptions)	Vérifie si une URL donnée correspond à des règles et des conditions et modifie le httpContext lors de la correspondance.
UseRouter(IApplicationBuilder, IRouter)	Ajoute un intergiciel RouterMiddleware au IApplicationBuilder spécifié avec le IRouterspécifié.
UseRouter(IApplicationBuilder, Action<IRouteBuilder>)	Ajoute un intergiciel RouterMiddleware au IApplicationBuilder spécifié avec le IRouter généré à partir de IRouteBuilderconfiguré.
Run(IApplicationBuilder, RequestDelegate)	Ajoute un délégué middleware terminal au pipeline de requête de l’application.
UseSession(IApplicationBuilder)	Ajoute le SessionMiddleware pour activer automatiquement l’état de session de l’application.
UseSession(IApplicationBuilder, SessionOptions)	Ajoute le SessionMiddleware pour activer automatiquement l’état de session de l’application.
UseSpa(IApplicationBuilder, Action<ISpaBuilder>)	Gère toutes les requêtes de ce point dans la chaîne d’intergiciels en retournant la page par défaut de l’application monopage (SPA). Cet intergiciel doit être placé tard dans la chaîne, afin que d’autres intergiciels pour servir des fichiers statiques, des actions MVC, etc., soient prioritaires.
UseStaticFiles(IApplicationBuilder)	Active le service de fichier statique pour le chemin d’accès de requête actuel
UseStaticFiles(IApplicationBuilder, StaticFileOptions)	Active le service de fichiers statiques avec les options données
UseStaticFiles(IApplicationBuilder, String)	Active le service de fichier statique pour le chemin de requête donné
UseStatusCodePages(IApplicationBuilder)	Ajoute un intergiciel StatusCodePages avec un gestionnaire de réponses par défaut qui vérifie les réponses avec des codes d’état compris entre 400 et 599 qui n’ont pas de corps.
UseStatusCodePages(IApplicationBuilder, StatusCodePagesOptions)	Ajoute un intergiciel StatusCodePages avec les options données qui vérifient les réponses avec des codes d’état compris entre 400 et 599 qui n’ont pas de corps.
UseStatusCodePages(IApplicationBuilder, Action<IApplicationBuilder>)	Ajoute un intergiciel StatusCodePages au pipeline avec le pipeline d’intergiciels secondaires 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 vérifie les réponses avec des codes d’état 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 d’état. L’intergiciel vérifie les réponses avec des codes d’état 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 d’état. Les URL commençant par « ~ » auront pathBase prépendées, où toute autre URL sera utilisée comme c’est le cas.
UseStatusCodePagesWithReExecute(IApplicationBuilder, String, String)	Ajoute un intergiciel StatusCodePages au pipeline. Spécifie que le corps de la réponse doit être généré en réexécutant le pipeline de requête à l’aide d’un autre chemin d’accès. Ce chemin peut contenir un espace réservé «{0}» du code d’état.
Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>)	Ajoute un délégué intergiciel 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é intergiciel 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 intergiciel qui extrait la base de chemin d’accès spécifiée à partir du chemin de requête et la postpende à la base de chemin d’accès de la requête.
UseWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Crée de façon conditionnelle une branche dans le pipeline de requête qui est jointe au pipeline principal.
UseWebAssemblyDebugging(IApplicationBuilder)	Ajoute l’intergiciel nécessaire pour le débogage d’applications Blazor WebAssembly dans les outils de développement Chromium.
UseWebSockets(IApplicationBuilder)	Ajoute la WebSocketMiddleware au pipeline de requête.
UseWebSockets(IApplicationBuilder, WebSocketOptions)	Ajoute la WebSocketMiddleware au pipeline de requête.
UseWelcomePage(IApplicationBuilder)	Ajoute welcomePageMiddleware au pipeline.
UseWelcomePage(IApplicationBuilder, WelcomePageOptions)	Ajoute welcomePageMiddleware au pipeline avec les options donné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 requête dans le pipeline.
UseRequestLatencyTelemetry(IApplicationBuilder)	Ajoute le middleware de télémétrie de latence des requêtes à IApplicationBuilder pipeline d’exécution de requête.
UseSpaStaticFiles(IApplicationBuilder)	Configure l’application pour traiter des fichiers statiques pour une application monopage (SPA). Les fichiers se trouvent à l’aide du service de ISpaStaticFileProvider inscrit.
UseSpaStaticFiles(IApplicationBuilder, StaticFileOptions)	Configure l’application pour traiter des fichiers statiques pour une application monopage (SPA). Les fichiers se trouvent à l’aide du service de ISpaStaticFileProvider inscrit.