IApplicationBuilder Interface

Obtient ou définit l’accès IServiceProvider au conteneur de service de l’application.

Obtient une collection clé/valeur qui peut être utilisée pour partager des données entre intergiciels.

Obtient l’ensemble des fonctionnalités HTTP fournies par le serveur de l’application.

Génère le délégué utilisé par cette application pour traiter les requêtes HTTP.

Crée un nouveau IApplicationBuilder qui partage ce PropertiesIApplicationBuilder.

Ajoute un délégué middleware au pipeline de requête de l’application.

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.

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.

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.

Branche le pipeline de requête en fonction du résultat du prédicat donné.

Ajoute un délégué middleware terminal au pipeline de requête de l’application.

Envoie la requête au serveur distant comme spécifié dans les options

Envoie la requête au serveur distant comme spécifié dans les options

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) plutôt.

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);
});

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) plutôt.

Ajoute l’intergiciel anti-falsification au pipeline.

Ajoute la AuthenticationMiddleware valeur à l’élément spécifié IApplicationBuilder, qui active les fonctionnalités d’authentification.

Ajoute la AuthorizationMiddleware valeur à l’élément spécifié IApplicationBuilder, 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 et app.UseRouting()app.UseEndpoints(...) pour que le middleware fonctionne correctement.

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é.

Configure l’application pour traiter les fichiers d’infrastructure Blazor WebAssembly à partir du chemin d’accès racine « / ».

Cette méthode est appelée pour activer le lien du navigateur dans une application. Il inscrit une méthode de fabrique qui crée BrowserLinkMiddleware pour chaque requête.

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.

Ajoute l’intergiciel ClaimsTransformationMiddleware à l’intergiciel spécifié IApplicationBuilder, qui active les fonctionnalités de transformation des revendications.

Ajoute l’intergiciel ClaimsTransformationMiddleware à l’intergiciel spécifié IApplicationBuilder, qui active les fonctionnalités de transformation des revendications.

Ajoute l’intergiciel ClaimsTransformationMiddleware à l’intergiciel spécifié IApplicationBuilder, qui active les fonctionnalités de transformation des revendications.

Ajoute le ConcurrencyLimiterMiddleware nombre de demandes en cours d’exécution simultanée.

Ajoute la prise en charge des gestionnaires de connexions ASP.NET Core au pipeline d’exécution de requête IApplicationBuilder.

Cette méthode est obsolète et sera supprimée dans une version ultérieure. L’alternative recommandée consiste à utiliser MapConnections ou MapConnectionHandler<TConnectionHandler> à l’intérieur de Microsoft. AspNetCore.Builder.UseEndpoints(...).

UseCookieAuthentication est obsolète. Configurez l’authentification des cookies avec AddAuthentication(). AddCookie dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

Ajoute l’intergiciel CookieAuthenticationMiddleware à l’intergiciel spécifié IApplicationBuilder, qui active les fonctionnalités d’authentification des cookies.

UseCookieAuthentication est obsolète. Configurez l’authentification des cookies avec AddAuthentication(). AddCookie dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

Ajoute le CookiePolicyMiddleware gestionnaire au gestionnaire spécifié IApplicationBuilder, qui active les fonctionnalités de stratégie de cookie.

Ajoute le CookiePolicyMiddleware gestionnaire au gestionnaire spécifié IApplicationBuilder, qui active les fonctionnalités de stratégie de cookie.

Ajoute un intergiciel CORS à votre pipeline d’application web pour autoriser les requêtes inter-domaines.

Ajoute un intergiciel CORS à votre pipeline d’application web pour autoriser les requêtes inter-domaines.

Ajoute un intergiciel CORS à votre pipeline d’application web pour autoriser les requêtes inter-domaines.

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.

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.

Active le mappage de fichiers par défaut avec les options données

Active le mappage de fichiers par défaut pour le chemin de requête donné

Active le mappage de fichiers par défaut sur le chemin d’accès actuel

Capture des instances synchrones et asynchrones Exception à partir du pipeline et génère des réponses d’erreur HTML.

Capture des instances synchrones et asynchrones Exception à partir du pipeline et génère des réponses d’erreur HTML.

Activer la navigation dans le répertoire avec les options données

Active la navigation dans le répertoire pour le chemin de requête donné

Activer la navigation dans le répertoire sur le chemin d’accès actuel

Active le service de journalisation Elm, accessible via le ElmPageMiddleware.

Permet d’afficher les journaux capturés par le ElmCaptureMiddleware.

Ajoute un intergiciel Microsoft.AspNetCore.Routing.EndpointMiddleware au > /IApplicationBuilder spécifié avec les instances EndpointDataSource générées à partir de IEndpointRouteBuilder configurées. La Microsoft.AspNetCore.Routing.EndpointMiddleware exécute le Endpoint associé à la requête actuelle.

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é.

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é.

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é.

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é.

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é.

UseFacebookAuthentication est obsolète. Configurez l’authentification Facebook avec AddAuthentication(). AddFacebook dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

Ajoute l’intergiciel FacebookMiddleware à l’intergiciel spécifié IApplicationBuilder, qui active les fonctionnalités d’authentification Facebook.

UseFacebookAuthentication est obsolète. Configurez l’authentification Facebook avec AddAuthentication(). AddFacebook dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

Activez tous les intergiciels de fichiers statiques pour le chemin de requête actuel dans le répertoire actif.

Activer tous les intergiciels de fichiers statiques avec les options données

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

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.

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. Lit ForwardedHeadersMiddleware ces en-têtes et remplit les champs associés sur HttpContext.

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. Lit ForwardedHeadersMiddleware ces en-têtes et remplit les champs associés sur HttpContext.

UseGoogleAuthentication est obsolète. Configurez l’authentification Google avec AddAuthentication(). AddGoogle dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

Ajoute le GoogleMiddleware middleware à l’élément spécifié IApplicationBuilder, qui active les fonctionnalités d’authentification Google.

UseGoogleAuthentication est obsolète. Configurez l’authentification Google avec AddAuthentication(). AddGoogle dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

Ajoute un intergiciel qui collecte les en-têtes à propager à un HttpClient.

Ajoute un intergiciel qui fournit l’état de contrôle d’intégrité.

Ajoute un intergiciel qui fournit l’état de contrôle d’intégrité.

Ajoute un intergiciel qui fournit l’état de contrôle d’intégrité.

Ajoute un intergiciel qui fournit l’état de contrôle d’intégrité.

Ajoute un intergiciel qui fournit l’état de contrôle d’intégrité.

Ajoute un intergiciel qui fournit l’état de contrôle d’intégrité.

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.

Ajoute un intergiciel pour l’utilisation de HSTS, qui ajoute l’en-tête Strict-Transport-Security.

Ajoute un intergiciel qui peut consigner les requêtes et réponses HTTP.

Inscrit le middleware de journalisation des requêtes HTTP entrantes dans IApplicationBuilder.

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.

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.

Ajoute un intergiciel pour rediriger les requêtes HTTP vers HTTPS.

Cette méthode est obsolète et sera supprimée dans une version ultérieure. L’alternative recommandée est UseAuthentication(IApplicationBuilder)

Active ASP.NET identité pour l’application actuelle.

UseJwtBearerAuthentication est obsolète. Configurez l’authentification JwtBearer avec AddAuthentication(). AddJwtBearer dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

Ajoute le JwtBearerMiddleware middleware à l’élément spécifié IApplicationBuilder, qui active les fonctionnalités de traitement des jetons du porteur. Ce middleware comprend les jetons correctement mis en forme et sécurisés qui apparaissent dans l’en-tête de requête. Si Options.AuthenticationMode est actif, les revendications du jeton du porteur sont ajoutées à l’utilisateur IPrincipal de la requête actuelle. Si Options.AuthenticationMode est passif, la requête actuelle n’est pas modifiée, mais IAuthenticationManager AuthenticateAsync peut être utilisé à tout moment pour obtenir les revendications du jeton du porteur de la requête. Voir aussi http://tools.ietf.org/html/rfc6749

UseJwtBearerAuthentication est obsolète. Configurez l’authentification JwtBearer avec AddAuthentication(). AddJwtBearer dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

UseMicrosoftAccountAuthentication est obsolète. Configurez l’authentification MicrosoftAccount avec AddAuthentication(). AddMicrosoftAccount dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

Ajoute le middleware MicrosoftAccountMiddleware au IApplicationBuilder spécifié, ce qui active les fonctionnalités d’authentification de compte Microsoft.

UseMicrosoftAccountAuthentication est obsolète. Configurez l’authentification MicrosoftAccount avec AddAuthentication(). AddMicrosoftAccount dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

Ajoute un type de middleware au pipeline de requête de l’application.

Ajoute un type de middleware au pipeline de requête de l’application.

Traite les demandes d’exécution des opérations de migration. L’intergiciel écoute les demandes adressées au chemin configuré dans options.

Traite les demandes d’exécution des opérations de migration. L’intergiciel écoute les demandes adressées à DefaultPath.

Ajoute MVC au pipeline d’exécution de IApplicationBuilder requête.

Ajoute MVC au pipeline d’exécution de IApplicationBuilder requête.

Ajoute MVC au IApplicationBuilder pipeline d’exécution de requête avec un itinéraire par défaut nommé « default » et le modèle suivant : « {controller=Home}/{action=Index}/{id ?} ».

UseOAuthAuthentication est obsolète. Configurez l’authentification OAuth avec AddAuthentication(). AddOAuth dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

Ajoute l’intergiciel OAuthMiddleware<TOptions> à l’intergiciel spécifié IApplicationBuilder, qui active les fonctionnalités d’authentification OAuth 2.0.

UseOAuthAuthentication est obsolète. Configurez l’authentification OAuth avec AddAuthentication(). AddOAuth dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

UseOpenIdConnectAuthentication est obsolète. Configurez l’authentification OpenIdConnect avec AddAuthentication(). AddOpenIdConnect dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

Ajoute l’intergiciel OpenIdConnectMiddleware à l’intergiciel spécifié IApplicationBuilder, qui active les fonctionnalités d’authentification OpenID Connect.

UseOpenIdConnectAuthentication est obsolète. Configurez l’authentification OpenIdConnect avec AddAuthentication(). AddOpenIdConnect dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

Ajoute la Microsoft.AspNetCore.OutputCaching.OutputCacheMiddleware pour la mise en cache des réponses HTTP.

Ajoute le pipeline d’intergiciel OWIN au pipeline spécifié IApplicationBuilder.

Ajoute un pipeline OWIN au fichier spécifié IApplicationBuilder.

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.

Active la limitation du débit pour l’application.

Active la limitation du débit pour l’application.

Inscrit l’intergiciel pour le point de contrôle de requête.

Inscrit les intergiciels liés au point de contrôle de requête dans le pipeline.

Ajoute un intergiciel pour décompresser dynamiquement les corps de requête HTTP.

Ajoute le middleware de télémétrie de latence des requêtes au IApplicationBuilder pipeline d’exécution de la requête.

Ajoute le middleware de télémétrie de latence des requêtes au IApplicationBuilder pipeline d’exécution de la requête.

Ajoute les informations de culture pour définir automatiquement les RequestLocalizationMiddleware informations de culture pour les demandes en fonction des informations fournies par le client.

Ajoute les informations de culture pour définir automatiquement les RequestLocalizationMiddleware informations de culture pour les demandes en fonction des informations fournies par le client.

Ajoute les informations de culture pour définir automatiquement les RequestLocalizationMiddleware informations de culture pour les demandes en fonction des informations fournies par le client.

Ajoute les informations de culture pour définir automatiquement les RequestLocalizationMiddleware informations de culture pour les demandes en fonction des informations fournies par le client.

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, sur les RequestTimeoutAttribute points de terminaison ou à l’aide des extensions de routage WithRequestTimeout.

Active la mise en mémoire tampon complète des corps de réponse. Cela peut être désactivé par requête à l’aide d’IHttpBufferingFeature.

Ajoute la ResponseCachingMiddleware mise en cache des réponses HTTP.

Ajoute un intergiciel pour compresser dynamiquement les réponses HTTP.

Vérifie si une URL donnée correspond à des règles et des conditions et modifie le httpContext lors de la correspondance.

Vérifie si une URL donnée correspond à des règles et des conditions et modifie le httpContext lors de la correspondance.

Ajoute un RouterMiddleware intergiciel à l’intergiciel spécifié IApplicationBuilder avec le IRouter logiciel généré à partir de configuré IRouteBuilder.

Ajoute un RouterMiddleware intergiciel à l’intergiciel spécifié IApplicationBuilder avec le logiciel spécifié IRouter.

Ajoute un intergiciel Microsoft.AspNetCore.Routing.EndpointRoutingMiddleware au IApplicationBuilder spécifié.

Ajoute l’option permettant d’activer automatiquement l’état SessionMiddleware de session pour l’application.

Ajoute l’option permettant d’activer automatiquement l’état SessionMiddleware de session pour l’application.

Ajoute SignalR au pipeline d’exécution de IApplicationBuilder la requête.

Cette méthode est obsolète et sera supprimée dans une version ultérieure. L’alternative recommandée consiste à utiliser MapHub<THub> à l’intérieur Microsoft. AspNetCore.Builder.UseEndpoints(...).

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.

Configure l’application pour traiter des fichiers statiques pour une application monopage (SPA). Les fichiers se trouvent à l’aide du service inscrit ISpaStaticFileProvider .

Configure l’application pour traiter des fichiers statiques pour une application monopage (SPA). Les fichiers se trouvent à l’aide du service inscrit ISpaStaticFileProvider .

Active le service de fichiers statiques avec les options données

Active le service de fichier statique pour le chemin de requête donné

Active le service de fichier statique pour le chemin d’accès de requête actuel

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.

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.

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. Si HandleAsync elle utilise sa valeur par défaut, elle tente de générer une ProblemDetails réponse à l’aide IProblemDetailsService d’une réponse de texte brut qui inclut le code d’état.

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.

Ajoute un StatusCodePagesMiddleware gestionnaire de réponses par défaut. L’intergiciel vérifie les réponses avec des codes d’état compris entre 400 et 599 qui n’ont pas de corps et, lorsqu’une IProblemDetailsService réponse est disponible, tente de générer une ProblemDetails réponse. Si le service n’est pas disponible ou ne peut pas écrire la réponse, il génère une réponse de texte brut qui inclut le code d’état.

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.

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 d’accès peut contenir un espace réservé «{0} » du code d’état.

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 d’accès peut contenir un espace réservé «{0} » du code d’état.

UseTwitterAuthentication est obsolète. Configurez l’authentification Twitter avec AddAuthentication(). AddTwitter dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

Ajoute l’intergiciel TwitterMiddleware à l’intergiciel spécifié IApplicationBuilder, qui active les fonctionnalités d’authentification Twitter.

UseTwitterAuthentication est obsolète. Configurez l’authentification Twitter avec AddAuthentication(). AddTwitter dans ConfigureServices. Consultez https://go.microsoft.com/fwlink/?linkid=845470 pour plus d’informations.

Ajoute un intergiciel qui peut consigner les requêtes ET réponses HTTP pour les journaux de serveur au format W3C.

Ajoute l’intergiciel nécessaire pour le débogage d’applications Blazor WebAssembly dans les outils de développement Chromium.

Active la prise en charge du middleware webpack dev. Cela héberge une instance du compilateur Webpack en mémoire dans votre application afin que vous puissiez toujours servir up-to-date des ressources webpack intégrées sans avoir à exécuter le compilateur manuellement. Étant donné que l’instance du compilateur Webpack est conservée en mémoire, la compilation incrémentielle est beaucoup plus rapide que la réexécutation du compilateur à partir de zéro.

Les requêtes entrantes qui correspondent aux fichiers générés par Webpack sont gérées en retournant directement la sortie du compilateur Webpack, quels que soient les fichiers sur le disque. Si la compilation est en cours lorsque la requête arrive, la réponse s’interrompt jusqu’à ce que la sortie du compilateur mise à jour soit prête.

Ajoute le WebSocketMiddleware pipeline de requête.

Ajoute le WebSocketMiddleware pipeline de requête.

Ajoute welcomePageMiddleware au pipeline avec le chemin d’accès donné.

Ajoute welcomePageMiddleware au pipeline avec le chemin d’accès donné.

Ajoute welcomePageMiddleware au pipeline avec les options données.

Ajoute welcomePageMiddleware au pipeline.

Crée de façon conditionnelle une branche dans le pipeline de requête qui est jointe au pipeline principal.