IApplicationBuilder Rozhraní

Definice

Obor názvů:

Microsoft.AspNetCore.Builder

Sestavení:

Microsoft.AspNetCore.Http.Abstractions.dll

Balíček:

Microsoft.AspNetCore.App.Ref v8.0.0

Zdroj:

IApplicationBuilder.cs

Definuje třídu, která poskytuje mechanismy pro konfiguraci kanálu žádosti aplikace.

public interface class IApplicationBuilder

public interface IApplicationBuilder

type IApplicationBuilder = interface

Public Interface IApplicationBuilder

Odvozené

Microsoft.AspNetCore.Builder.ApplicationBuilder

Microsoft.AspNetCore.Builder.WebApplication

Microsoft.AspNetCore.MiddlewareAnalysis.AnalysisBuilder

Vlastnosti

ApplicationServices	Získá nebo nastaví IServiceProvider, který poskytuje přístup k kontejneru služby aplikace.
Properties	Získá kolekci klíč/hodnota, která se dá použít ke sdílení dat mezi middlewarem.
ServerFeatures	Získá sadu funkcí HTTP, které poskytuje server aplikace.

Metody

Build()	Vytvoří delegáta, který tato aplikace používá ke zpracování požadavků HTTP.
New()	Vytvoří nový IApplicationBuilder, který sdílí Properties tohoto IApplicationBuilder.
Use(Func<RequestDelegate,RequestDelegate>)	Přidá do kanálu žádosti aplikace delegáta middlewaru.

Metody rozšíření

UseAntiforgery(IApplicationBuilder)	Přidá do kanálu anti-forgery middleware.
UseRequestLocalization(IApplicationBuilder)	Přidá RequestLocalizationMiddleware k automatickému nastavení informací jazykové verze pro požadavky na základě informací poskytovaných klientem.
UseRequestLocalization(IApplicationBuilder, RequestLocalizationOptions)	Přidá RequestLocalizationMiddleware k automatickému nastavení informací jazykové verze pro požadavky na základě informací poskytovaných klientem.
UseRequestLocalization(IApplicationBuilder, Action<RequestLocalizationOptions>)	Přidá RequestLocalizationMiddleware k automatickému nastavení informací jazykové verze pro požadavky na základě informací poskytovaných klientem.
UseRequestLocalization(IApplicationBuilder, String[])	Přidá RequestLocalizationMiddleware k automatickému nastavení informací jazykové verze pro požadavky na základě informací poskytovaných klientem.
UseAuthentication(IApplicationBuilder)	Přidá AuthenticationMiddleware do zadaného IApplicationBuilder, což umožňuje možnosti ověřování.
UseAuthorization(IApplicationBuilder)	Přidá AuthorizationMiddleware do zadaného IApplicationBuilder, což umožňuje možnosti autorizace. Při autorizaci prostředku směrovaného pomocí směrování koncového bodu se toto volání musí objevit mezi voláními app.UseRouting() a app.UseEndpoints(...), aby middleware fungoval správně.
UseCertificateForwarding(IApplicationBuilder)	Přidá do kanálu middleware, který bude hledat certifikát v hlavičce požadavku, dekóduje ho a aktualizuje HttpContext.Connection.ClientCertificate.
UseBlazorFrameworkFiles(IApplicationBuilder)	Nakonfiguruje aplikaci tak, aby sloužila souborům architektury Blazor WebAssembly z kořenové cesty /.
UseBlazorFrameworkFiles(IApplicationBuilder, PathString)	Nakonfiguruje aplikaci tak, aby obsluhovat soubory rozhraní Blazor WebAssembly z cesty pathPrefix. Tato cesta musí odpovídat odkazovanému projektu aplikace Blazor WebAssembly.
UseConcurrencyLimiter(IApplicationBuilder)	Zastaralé. Přidá ConcurrencyLimiterMiddleware, aby se omezil počet souběžně spouštěných požadavků.
UseCookiePolicy(IApplicationBuilder)	Přidá obslužnou rutinu CookiePolicyMiddleware do zadaného IApplicationBuilder, což umožňuje možnosti zásad souborů cookie.
UseCookiePolicy(IApplicationBuilder, CookiePolicyOptions)	Přidá obslužnou rutinu CookiePolicyMiddleware do zadaného IApplicationBuilder, což umožňuje možnosti zásad souborů cookie.
UseCors(IApplicationBuilder)	Přidá do kanálu webové aplikace middleware CORS, který povolí požadavky mezi doménami.
UseCors(IApplicationBuilder, Action<CorsPolicyBuilder>)	Přidá do kanálu webové aplikace middleware CORS, který povolí požadavky mezi doménami.
UseCors(IApplicationBuilder, String)	Přidá do kanálu webové aplikace middleware CORS, který povolí požadavky mezi doménami.
UseDatabaseErrorPage(IApplicationBuilder)	Zastaralé. Zaznamenává synchronní a asynchronní výjimky související s databází z kanálu, které je možné vyřešit pomocí migrací entity Framework. Pokud dojde k těmto výjimkám, vygeneruje se odpověď HTML s podrobnostmi o možných akcích k vyřešení problému.
UseDatabaseErrorPage(IApplicationBuilder, DatabaseErrorPageOptions)	Zastaralé. Zaznamenává synchronní a asynchronní výjimky související s databází z kanálu, které je možné vyřešit pomocí migrací entity Framework. Pokud dojde k těmto výjimkám, vygeneruje se odpověď HTML s podrobnostmi o možných akcích k vyřešení problému.
UseDefaultFiles(IApplicationBuilder)	Povolí výchozí mapování souborů na aktuální cestě.
UseDefaultFiles(IApplicationBuilder, DefaultFilesOptions)	Povolí výchozí mapování souborů s danými možnostmi.
UseDefaultFiles(IApplicationBuilder, String)	Povolí výchozí mapování souborů pro danou cestu požadavku.
UseDeveloperExceptionPage(IApplicationBuilder)	Zaznamenává synchronní a asynchronní Exception instance z kanálu a generuje chybové odpovědi HTML.
UseDeveloperExceptionPage(IApplicationBuilder, DeveloperExceptionPageOptions)	Zaznamenává synchronní a asynchronní Exception instance z kanálu a generuje chybové odpovědi HTML.
UseDirectoryBrowser(IApplicationBuilder)	Povolení procházení adresářů na aktuální cestě
UseDirectoryBrowser(IApplicationBuilder, DirectoryBrowserOptions)	Povolení procházení adresářů s danými možnostmi
UseDirectoryBrowser(IApplicationBuilder, String)	Povolí procházení adresářů pro danou cestu požadavku.
UseEndpoints(IApplicationBuilder, Action<IEndpointRouteBuilder>)	Přidá Microsoft.AspNetCore.Routing.EndpointMiddleware middleware do zadaného IApplicationBuilder s instancemi EndpointDataSource sestavenými z nakonfigurovaných IEndpointRouteBuilder. Microsoft.AspNetCore.Routing.EndpointMiddleware spustí Endpoint přidružené k aktuálnímu požadavku.
UseRouting(IApplicationBuilder)	Přidá Microsoft.AspNetCore.Routing.EndpointRoutingMiddleware middleware do zadaného IApplicationBuilder.
UseExceptionHandler(IApplicationBuilder)	Přidá do kanálu middleware, který zachytí výjimky, zapíše je do protokolu a znovu spustí požadavek v alternativním kanálu. Pokud už odpověď začala, požadavek se znovu nespustí.
UseExceptionHandler(IApplicationBuilder, ExceptionHandlerOptions)	Přidá do kanálu middleware, který zachytí výjimky, zapíše je do protokolu a znovu spustí požadavek v alternativním kanálu. Pokud už odpověď začala, požadavek se znovu nespustí.
UseExceptionHandler(IApplicationBuilder, Action<IApplicationBuilder>)	Přidá do kanálu middleware, který zachytí výjimky, zapíše je do protokolu a znovu spustí požadavek v alternativním kanálu. Pokud už odpověď začala, požadavek se znovu nespustí.
UseExceptionHandler(IApplicationBuilder, String)	Přidá do kanálu middleware, který zachytí výjimky, zapíše je, resetuje cestu požadavku a znovu spustí požadavek. Pokud už odpověď začala, požadavek se znovu nespustí.
UseExceptionHandler(IApplicationBuilder, String, Boolean)	Přidá do kanálu middleware, který zachytí výjimky, zapíše je, resetuje cestu požadavku a znovu spustí požadavek. Pokud už odpověď začala, požadavek se znovu nespustí.
UseFileServer(IApplicationBuilder)	Povolte veškerý middleware statického souboru (kromě procházení adresářů) pro aktuální cestu požadavku v aktuálním adresáři.
UseFileServer(IApplicationBuilder, FileServerOptions)	Povolení veškerého middlewaru statického souboru s danými možnostmi
UseFileServer(IApplicationBuilder, Boolean)	Povolte veškerý middleware statického souboru pro aktuální cestu požadavku v aktuálním adresáři.
UseFileServer(IApplicationBuilder, String)	Povolí veškerý middleware statického souboru (kromě procházení adresářů) pro danou cestu požadavku z adresáře se stejným názvem.
UseForwardedHeaders(IApplicationBuilder)	Použije předávané hlavičky na odpovídající pole aktuálního požadavku. Proxy servery HTTP podle konvence předávají informace z klienta v dobře známých hlavičkách HTTP. ForwardedHeadersMiddleware přečte tato záhlaví a vyplní přidružená pole v httpContext.
UseForwardedHeaders(IApplicationBuilder, ForwardedHeadersOptions)	Použije předávané hlavičky na odpovídající pole aktuálního požadavku. Proxy servery HTTP podle konvence předávají informace z klienta v dobře známých hlavičkách HTTP. ForwardedHeadersMiddleware přečte tato záhlaví a vyplní přidružená pole v httpContext.
UseHeaderPropagation(IApplicationBuilder)	Přidá middleware, který shromažďuje hlavičky, které se mají rozšířit do HttpClient.
UseHealthChecks(IApplicationBuilder, PathString)	Přidá middleware, který poskytuje stav kontroly stavu.
UseHealthChecks(IApplicationBuilder, PathString, HealthCheckOptions)	Přidá middleware, který poskytuje stav kontroly stavu.
UseHealthChecks(IApplicationBuilder, PathString, Int32)	Přidá middleware, který poskytuje stav kontroly stavu.
UseHealthChecks(IApplicationBuilder, PathString, Int32, HealthCheckOptions)	Přidá middleware, který poskytuje stav kontroly stavu.
UseHealthChecks(IApplicationBuilder, PathString, String)	Přidá middleware, který poskytuje stav kontroly stavu.
UseHealthChecks(IApplicationBuilder, PathString, String, HealthCheckOptions)	Přidá middleware, který poskytuje stav kontroly stavu.
UseHostFiltering(IApplicationBuilder)	Přidá middleware pro filtrování požadavků podle povolených hlaviček hostitelů. Neplatné požadavky budou odmítnuty se stavovým kódem 400.
UseHsts(IApplicationBuilder)	Přidá middleware pro použití HSTS, který přidá hlavičku Strict-Transport-Security.
UseHttpLogging(IApplicationBuilder)	Přidá middleware, který může protokolovat požadavky a odpovědi HTTP.
UseW3CLogging(IApplicationBuilder)	Přidá middleware, který může protokolovat požadavky HTTP a odpovědi pro protokoly serveru ve formátu W3C.
UseHttpMethodOverride(IApplicationBuilder)	Umožňuje příchozí požadavek POST přepsat typ metody typem zadaným v hlavičce. Tento middleware se používá, když je klient omezen na odesílání metod GET nebo POST, ale chce vyvolat jiné metody HTTP. Ve výchozím nastavení se hlavička požadavku X-HTTPMethod-Override používá k určení tunelové metody HTTP.
UseHttpMethodOverride(IApplicationBuilder, HttpMethodOverrideOptions)	Umožňuje příchozí požadavek POST přepsat typ metody s typem zadaným ve formuláři. Tento middleware se používá, když je klient omezen na odesílání metod GET nebo POST, ale chce vyvolat jiné metody HTTP.
UseHttpsRedirection(IApplicationBuilder)	Přidá middleware pro přesměrování požadavků HTTP na HTTPS.
Map(IApplicationBuilder, PathString, Action<IApplicationBuilder>)	Rozdělí kanál požadavku na základě shody dané cesty požadavku. Pokud cesta požadavku začíná danou cestou, spustí se větev.
Map(IApplicationBuilder, PathString, Boolean, Action<IApplicationBuilder>)	Rozdělí kanál požadavku na základě shody dané cesty požadavku. Pokud cesta požadavku začíná danou cestou, spustí se větev.
Map(IApplicationBuilder, String, Action<IApplicationBuilder>)	Rozdělí kanál požadavku na základě shody dané cesty požadavku. Pokud cesta požadavku začíná danou cestou, spustí se větev.
MapWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Rozdělí kanál požadavku na základě výsledku daného predikátu.
UseMigrationsEndPoint(IApplicationBuilder)	Zpracovává požadavky na provádění operací migrace. Middleware bude naslouchat žádostem provedeným DefaultPath.
UseMigrationsEndPoint(IApplicationBuilder, MigrationsEndPointOptions)	Zpracovává požadavky na provádění operací migrace. Middleware bude naslouchat požadavkům na cestu nakonfigurovanou v options.
UseMvc(IApplicationBuilder)	Přidá MVC do kanálu spuštění IApplicationBuilder žádosti.
UseMvc(IApplicationBuilder, Action<IRouteBuilder>)	Přidá MVC do kanálu spuštění IApplicationBuilder žádosti.
UseMvcWithDefaultRoute(IApplicationBuilder)	Přidá MVC do kanálu spuštění požadavku IApplicationBuilder s výchozí trasou s názvem default a následující šablonou: {controller=Home}/{action=Index}/{id?}.
UseOutputCache(IApplicationBuilder)	Přidá Microsoft.AspNetCore.OutputCaching.OutputCacheMiddleware pro ukládání odpovědí HTTP do mezipaměti.
UseOwin(IApplicationBuilder)	Přidá kanál OWIN do zadaného IApplicationBuilder.
UseOwin(IApplicationBuilder, Action<Action<Func<Func<IDictionary<String,Object>,Task>,Func<IDictionary<String,Object>,Task>>>>)	Přidá middlewarový kanál OWIN do zadaného IApplicationBuilder.
UseRateLimiter(IApplicationBuilder)	Povolí omezení rychlosti pro aplikaci.
UseRateLimiter(IApplicationBuilder, RateLimiterOptions)	Povolí omezení rychlosti pro aplikaci.
UseRequestDecompression(IApplicationBuilder)	Přidá middleware pro dynamické dekompresi těla požadavků HTTP.
UseRequestTimeouts(IApplicationBuilder)	Povolí vypršení časových limitů požadavků pro aplikaci. Ve výchozím nastavení nejsou nakonfigurované žádné časové limity. Musí být nakonfigurované v RequestTimeoutOptions, RequestTimeoutAttribute na koncových bodech nebo pomocí rozšíření směrování WithRequestTimeout.
UseResponseCaching(IApplicationBuilder)	Přidá ResponseCachingMiddleware pro ukládání odpovědí HTTP do mezipaměti.
UseResponseCompression(IApplicationBuilder)	Přidává middleware pro dynamické komprimování odpovědí HTTP.
UseRewriter(IApplicationBuilder)	Zkontroluje, jestli daná adresa URL odpovídá pravidlům a podmínkám, a upraví httpContext podle shody.
UseRewriter(IApplicationBuilder, RewriteOptions)	Zkontroluje, jestli daná adresa URL odpovídá pravidlům a podmínkám, a upraví httpContext podle shody.
UseRouter(IApplicationBuilder, IRouter)	Přidá RouterMiddleware middleware do zadaného IApplicationBuilder se zadaným IRouter.
UseRouter(IApplicationBuilder, Action<IRouteBuilder>)	Přidá do zadaného IApplicationBuilder middleware RouterMiddleware s IRouter vytvořeným z nakonfigurovaného IRouteBuilder.
Run(IApplicationBuilder, RequestDelegate)	Přidá delegáta middlewaru terminálu do kanálu žádosti aplikace.
UseSession(IApplicationBuilder)	Přidá SessionMiddleware pro automatické povolení stavu relace pro aplikaci.
UseSession(IApplicationBuilder, SessionOptions)	Přidá SessionMiddleware pro automatické povolení stavu relace pro aplikaci.
UseSpa(IApplicationBuilder, Action<ISpaBuilder>)	Zpracovává všechny požadavky z tohoto bodu v řetězu middlewaru vrácením výchozí stránky jednostránkové aplikace (SPA). Tento middleware by měl být umístěn pozdě v řetězci, aby měl přednost jiný middleware pro obsluhu statických souborů, akcí MVC atd..
UseStaticFiles(IApplicationBuilder)	Povolí obsluhu statického souboru pro aktuální cestu požadavku.
UseStaticFiles(IApplicationBuilder, StaticFileOptions)	Povolí obsluhu statických souborů s danými možnostmi.
UseStaticFiles(IApplicationBuilder, String)	Povolí obsluhu statického souboru pro danou cestu požadavku.
UseStatusCodePages(IApplicationBuilder)	Přidá middleware StatusCodePages s výchozí obslužnou rutinou odpovědi, která kontroluje odpovědi se stavovými kódy mezi 400 a 599, které nemají tělo.
UseStatusCodePages(IApplicationBuilder, StatusCodePagesOptions)	Přidá middleware StatusCodePages s danými možnostmi, které kontrolují odpovědi se stavovými kódy mezi 400 a 599, které nemají tělo.
UseStatusCodePages(IApplicationBuilder, Action<IApplicationBuilder>)	Přidá do kanálu middleware StatusCodePages se zadaným alternativním middlewarovým kanálem, který se má spustit, aby se vygeneroval text odpovědi.
UseStatusCodePages(IApplicationBuilder, Func<StatusCodeContext,Task>)	Přidá middleware StatusCodePages se zadanou obslužnou rutinou, která kontroluje odpovědi se stavovými kódy mezi 400 a 599, které nemají tělo.
UseStatusCodePages(IApplicationBuilder, String, String)	Přidá middleware StatusCodePages se zadaným textem odpovědi, který se má odeslat. Může se jednat o zástupný symbol{0}pro stavový kód. Middleware kontroluje odpovědi se stavovými kódy mezi 400 a 599, které neobsahují tělo.
UseStatusCodePagesWithRedirects(IApplicationBuilder, String)	Přidá do kanálu middleware StatusCodePages. Určuje, že odpovědi by se měly zpracovat přesměrováním s danou šablonou adresy URL umístění. Může se jednat o zástupný symbol{0}pro stavový kód. Adresy URL začínající na ~budou mít před sebou PathBase, kde se použije jakákoli jiná adresa URL, jak je.
UseStatusCodePagesWithReExecute(IApplicationBuilder, String, String)	Přidá do kanálu middleware StatusCodePages. Určuje, že text odpovědi by se měl vygenerovat opětovným spuštěním kanálu požadavku pomocí alternativní cesty. Tato cesta může obsahovat zástupný symbol{0}stavového kódu.
Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>)	Přidá do kanálu požadavku aplikace delegovaný middleware definovaný v řádku. Pokud další funkci nevoláte, použijte místo toho Run(IApplicationBuilder, RequestDelegate).
Use(IApplicationBuilder, Func<HttpContext,Func<Task>,Task>)	Přidá do kanálu požadavku aplikace delegovaný middleware definovaný v řádku. Pokud další funkci nevoláte, použijte místo toho Run(IApplicationBuilder, RequestDelegate). Preferujete použití Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>) pro lepší výkon, jak je znázorněno níže: app.Use((context, next) => { return next(context); });
UseMiddleware(IApplicationBuilder, Type, Object[])	Přidá typ middlewaru do kanálu žádosti aplikace.
UseMiddleware<TMiddleware>(IApplicationBuilder, Object[])	Přidá typ middlewaru do kanálu žádosti aplikace.
UsePathBase(IApplicationBuilder, PathString)	Přidá middleware, který extrahuje zadanou základnu cesty z cesty požadavku a odešle ji do základu cesty požadavku.
UseWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Podmíněně vytvoří větev v kanálu požadavku, který se znovu připojí k hlavnímu kanálu.
UseWebAssemblyDebugging(IApplicationBuilder)	Přidává middleware potřebný k ladění aplikací Blazor WebAssembly v rámci nástrojů Chromium pro vývoj.
UseWebSockets(IApplicationBuilder)	Přidá WebSocketMiddleware do kanálu požadavku.
UseWebSockets(IApplicationBuilder, WebSocketOptions)	Přidá WebSocketMiddleware do kanálu požadavku.
UseWelcomePage(IApplicationBuilder)	Přidá do kanálu welcomePageMiddleware.
UseWelcomePage(IApplicationBuilder, WelcomePageOptions)	Přidá welcomePageMiddleware do kanálu s danými možnostmi.
UseWelcomePage(IApplicationBuilder, PathString)	Přidá WelcomePageMiddleware do kanálu s danou cestou.
UseWelcomePage(IApplicationBuilder, String)	Přidá WelcomePageMiddleware do kanálu s danou cestou.
UseHttpLoggingMiddleware(IApplicationBuilder)	Zaregistruje middleware protokolování příchozího požadavku HTTP do IApplicationBuilder.
UseRequestCheckpoint(IApplicationBuilder)	Zaregistruje do kanálu middlewary související s kontrolním bodem požadavku.
UseRequestLatencyTelemetry(IApplicationBuilder)	Přidá middleware telemetrie latence požadavku do kanálu spuštění požadavku IApplicationBuilder.
UseSpaStaticFiles(IApplicationBuilder)	Nakonfiguruje aplikaci tak, aby obsluhovat statické soubory pro jednostránkovou aplikaci (SPA). Soubory se budou nacházet pomocí registrované služby ISpaStaticFileProvider.
UseSpaStaticFiles(IApplicationBuilder, StaticFileOptions)	Nakonfiguruje aplikaci tak, aby obsluhovat statické soubory pro jednostránkovou aplikaci (SPA). Soubory se budou nacházet pomocí registrované služby ISpaStaticFileProvider.