ApplicationBuilder Třída

Definice

Obor názvů:

Microsoft.AspNetCore.Builder

Sestavení:

Microsoft.AspNetCore.Http.dll

Balíček:

Microsoft.AspNetCore.App.Ref v8.0.0

Výchozí implementace pro IApplicationBuilder.

public ref class ApplicationBuilder : Microsoft::AspNetCore::Builder::IApplicationBuilder

public class ApplicationBuilder : Microsoft.AspNetCore.Builder.IApplicationBuilder

type ApplicationBuilder = class
    interface IApplicationBuilder

Public Class ApplicationBuilder
Implements IApplicationBuilder

Dědičnost

Object

ApplicationBuilder

Implementuje

IApplicationBuilder

Konstruktory

ApplicationBuilder(IServiceProvider)	Inicializuje novou instanci objektu ApplicationBuilder.
ApplicationBuilder(IServiceProvider, Object)	Inicializuje novou instanci objektu ApplicationBuilder.

Vlastnosti

ApplicationServices	IServiceProvider Získá pro aplikační služby.
Properties	Získá sadu vlastností pro ApplicationBuilder.
ServerFeatures	IFeatureCollection Získá funkce serveru pro.

Metody

Build()	Vytvoří objekt RequestDelegate , který spouští přidané middlewary.
New()	Vytvoří kopii tohoto tvůrce aplikace. Vytvořený klon má stejné vlastnosti jako aktuální instance, ale nekopíruje kanál požadavku.
Use(Func<RequestDelegate,RequestDelegate>)	Přidá middleware do kanálu žádosti aplikace.

Metody rozšíření

UseAntiforgery(IApplicationBuilder)	Přidá middleware anti-forgery do kanálu.
UseRequestLocalization(IApplicationBuilder)	RequestLocalizationMiddleware Přidá k automatickému nastavení informací o jazykové verzi pro požadavky na základě informací poskytnutých klientem.
UseRequestLocalization(IApplicationBuilder, RequestLocalizationOptions)	RequestLocalizationMiddleware Přidá k automatickému nastavení informací o jazykové verzi pro požadavky na základě informací poskytnutých klientem.
UseRequestLocalization(IApplicationBuilder, Action<RequestLocalizationOptions>)	RequestLocalizationMiddleware Přidá k automatickému nastavení informací o jazykové verzi pro požadavky na základě informací poskytnutých klientem.
UseRequestLocalization(IApplicationBuilder, String[])	RequestLocalizationMiddleware Přidá k automatickému nastavení informací o jazykové verzi pro požadavky na základě informací poskytnutých klientem.
UseAuthentication(IApplicationBuilder)	Přidá do zadaného IApplicationBuilderparametru AuthenticationMiddleware , který umožňuje možnosti ověřování.
UseAuthorization(IApplicationBuilder)	Přidá do zadaného IApplicationBuilderparametru AuthorizationMiddleware , který umožňuje možnosti autorizace. Při autorizaci prostředku, který je směrován pomocí směrování koncového bodu, musí se toto volání 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ódování a aktualizuje HttpContext.Connection.ClientCertificate.
UseBlazorFrameworkFiles(IApplicationBuilder)	Nakonfiguruje aplikaci tak, aby poskytovala soubory architektury Blazor WebAssembly z kořenové cesty "/".
UseBlazorFrameworkFiles(IApplicationBuilder, PathString)	Nakonfiguruje aplikaci tak, aby poskytovala soubory architektury Blazor WebAssembly z cesty pathPrefix. Tato cesta musí odpovídat odkazovanému projektu aplikace Blazor WebAssembly.
UseConcurrencyLimiter(IApplicationBuilder)	Zastaralé. Přidá k ConcurrencyLimiterMiddleware omezení počtu souběžně spouštěných požadavků.
UseCookiePolicy(IApplicationBuilder)	Přidá obslužnou rutinu CookiePolicyMiddleware do zadaného IApplicationBuildersouboru , který umožňuje možnosti zásad souborů cookie.
UseCookiePolicy(IApplicationBuilder, CookiePolicyOptions)	Přidá obslužnou rutinu CookiePolicyMiddleware do zadaného IApplicationBuildersouboru , který umožňuje možnosti zásad souborů cookie.
UseCors(IApplicationBuilder)	Přidá middleware CORS do kanálu webové aplikace pro povolení požadavků mezi doménami.
UseCors(IApplicationBuilder, Action<CorsPolicyBuilder>)	Přidá middleware CORS do kanálu webové aplikace pro povolení požadavků mezi doménami.
UseCors(IApplicationBuilder, String)	Přidá middleware CORS do kanálu webové aplikace pro povolení požadavků mezi doménami.
UseDatabaseErrorPage(IApplicationBuilder)	Zastaralé. Zaznamenává synchronní a asynchronní výjimky související s databází z kanálu, které lze vyřešit pomocí migrací Entity Framework. Když 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é lze vyřešit pomocí migrací Entity Framework. Když 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 odpovědi na chyby HTML.
UseDeveloperExceptionPage(IApplicationBuilder, DeveloperExceptionPageOptions)	Zaznamenává synchronní a asynchronní Exception instance z kanálu a generuje odpovědi na chyby HTML.
UseDirectoryBrowser(IApplicationBuilder)	Povolení procházení adresářů na aktuální cestě
UseDirectoryBrowser(IApplicationBuilder, DirectoryBrowserOptions)	Povolení procházení adresářů s využitím daných možností
UseDirectoryBrowser(IApplicationBuilder, String)	Povolí procházení adresářů pro danou cestu požadavku.
UseEndpoints(IApplicationBuilder, Action<IEndpointRouteBuilder>)	Microsoft.AspNetCore.Routing.EndpointMiddleware Přidá middleware do zadaného IApplicationBuilder s EndpointDataSource instancemi sestavenými z nakonfigurovaného IEndpointRouteBuilder. Provede Microsoft.AspNetCore.Routing.EndpointMiddleware přidruženou k Endpoint aktuálnímu požadavku.
UseRouting(IApplicationBuilder)	Microsoft.AspNetCore.Routing.EndpointRoutingMiddleware Přidá middleware do zadaného IApplicationBuilderobjektu .
UseExceptionHandler(IApplicationBuilder)	Přidá do kanálu middleware, který bude zachycovat výjimky, protokolovat je a znovu spustit požadavek v alternativním kanálu. Pokud už byla odpověď spuštěna, požadavek se znovu nespustí.
UseExceptionHandler(IApplicationBuilder, ExceptionHandlerOptions)	Přidá do kanálu middleware, který bude zachycovat výjimky, protokolovat je a znovu spustit požadavek v alternativním kanálu. Pokud už byla odpověď spuštěna, požadavek se znovu nespustí.
UseExceptionHandler(IApplicationBuilder, Action<IApplicationBuilder>)	Přidá do kanálu middleware, který bude zachycovat výjimky, protokolovat je a znovu spustit požadavek v alternativním kanálu. Pokud už byla odpověď spuštěna, požadavek se znovu nespustí.
UseExceptionHandler(IApplicationBuilder, String)	Přidá do kanálu middleware, který zachytí výjimky, zapíše je, resetuje cestu k požadavku a znovu spustí požadavek. Pokud už byla odpověď spuštěna, požadavek se znovu nespustí.
UseExceptionHandler(IApplicationBuilder, String, Boolean)	Přidá do kanálu middleware, který zachytí výjimky, zapíše je, resetuje cestu k požadavku a znovu spustí požadavek. Pokud už byla odpověď spuštěna, požadavek se znovu nespustí.
UseFileServer(IApplicationBuilder)	Povolte pro aktuální cestu požadavku v aktuálním adresáři veškerý middleware statického souboru (s výjimkou procházení adresáře).
UseFileServer(IApplicationBuilder, FileServerOptions)	Povolení veškerého middlewaru statických souborů s danými možnostmi
UseFileServer(IApplicationBuilder, Boolean)	Povolte pro aktuální cestu k požadavku v aktuálním adresáři všech middlewarů statických souborů zapnutý.
UseFileServer(IApplicationBuilder, String)	Povolí veškerý middleware statického souboru (s výjimkou procházení adresářů) pro danou cestu požadavku z adresáře se stejným názvem.
UseForwardedHeaders(IApplicationBuilder)	Použije přeposlané hlavičky na odpovídající pole aktuálního požadavku. Podle konvence předávají proxy servery HTTP informace z klienta v dobře známých hlavičkách HTTP. Přečte ForwardedHeadersMiddleware tyto hlavičky a vyplní přidružená pole v HttpContextu.
UseForwardedHeaders(IApplicationBuilder, ForwardedHeadersOptions)	Použije přeposlané hlavičky na odpovídající pole aktuálního požadavku. Podle konvence předávají proxy servery HTTP informace z klienta v dobře známých hlavičkách HTTP. Přečte ForwardedHeadersMiddleware tyto hlavičky a vyplní přidružená pole v HttpContextu.
UseHeaderPropagation(IApplicationBuilder)	Přidá middleware, který shromažďuje hlavičky, které se mají rozšířit do objektu 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ý dokáže protokolovat požadavky a odpovědi HTTP.
UseW3CLogging(IApplicationBuilder)	Přidá middleware, který dokáže protokolovat požadavky HTTP a odpovědi na protokoly serveru ve formátu W3C.
UseHttpMethodOverride(IApplicationBuilder)	Umožňuje příchozímu požadavku POST přepsat typ metody s 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-HTTP-Method-Override používá k určení metody HTTP, která se tuneluje.
UseHttpMethodOverride(IApplicationBuilder, HttpMethodOverrideOptions)	Umožňuje příchozímu požadavku 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>)	Rozvětví kanál žádosti na základě shod dané cesty požadavku. Pokud cesta k požadavku začíná danou cestou, větev se spustí.
Map(IApplicationBuilder, PathString, Boolean, Action<IApplicationBuilder>)	Rozvětví kanál žádosti na základě shod dané cesty požadavku. Pokud cesta k požadavku začíná danou cestou, větev se spustí.
Map(IApplicationBuilder, String, Action<IApplicationBuilder>)	Rozvětví kanál žádosti na základě shod dané cesty požadavku. Pokud cesta k požadavku začíná danou cestou, větev se spustí.
MapWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Rozvětví 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 požadavkům provedeným na DefaultPathadresu .
UseMigrationsEndPoint(IApplicationBuilder, MigrationsEndPointOptions)	Zpracovává požadavky na provádění operací migrace. Middleware bude naslouchat požadavkům na cestu nakonfigurovanou v nástroji options.
UseMvc(IApplicationBuilder)	Přidá MVC do IApplicationBuilder kanálu provádění požadavků.
UseMvc(IApplicationBuilder, Action<IRouteBuilder>)	Přidá MVC do IApplicationBuilder kanálu provádění požadavků.
UseMvcWithDefaultRoute(IApplicationBuilder)	Přidá MVC do IApplicationBuilder kanálu provádění požadavků s výchozí trasou s názvem default a následující šablonou: {controller=Home}/{action=Index}/{id?}.
UseOutputCache(IApplicationBuilder)	Výchozí implementace pro IApplicationBuilder.
UseOwin(IApplicationBuilder)	Přidá kanál OWIN do zadaného IApplicationBuilderobjektu .
UseOwin(IApplicationBuilder, Action<Action<Func<Func<IDictionary<String,Object>,Task>,Func<IDictionary<String,Object>,Task>>>>)	Přidá kanál middlewaru OWIN do zadaného IApplicationBuilder.
UseRateLimiter(IApplicationBuilder)	Povolí omezení rychlosti pro aplikaci.
UseRateLimiter(IApplicationBuilder, RateLimiterOptions)	Povolí omezení rychlosti pro aplikaci.
UseRequestDecompression(IApplicationBuilder)	Přidává middleware pro dynamickou dekompresi těl požadavků HTTP.
UseRequestTimeouts(IApplicationBuilder)	Povolí pro aplikaci vypršení časového limitu požadavků. Ve výchozím nastavení nejsou nakonfigurované žádné časové limity. Musí být nakonfigurované v RequestTimeoutOptions, na RequestTimeoutAttribute koncových bodech nebo pomocí rozšíření směrování WithRequestTimeout.
UseResponseCaching(IApplicationBuilder)	Přidá pro ResponseCachingMiddleware ukládání odpovědí HTTP do mezipaměti.
UseResponseCompression(IApplicationBuilder)	Přidává middleware pro dynamickou komprimaci odpovědí HTTP.
UseRewriter(IApplicationBuilder)	Zkontroluje, jestli daná adresa URL odpovídá pravidlům a podmínkám, a upraví httpContext při shodě.
UseRewriter(IApplicationBuilder, RewriteOptions)	Zkontroluje, jestli daná adresa URL odpovídá pravidlům a podmínkám, a upraví httpContext při shodě.
UseRouter(IApplicationBuilder, IRouter)	RouterMiddleware Přidá middleware k zadanému IApplicationBuilder se zadaným IRouter.
UseRouter(IApplicationBuilder, Action<IRouteBuilder>)	RouterMiddleware Přidá middleware do zadaného IApplicationBuilderIRouter s nakonfigurovaným IRouteBuilder.
Run(IApplicationBuilder, RequestDelegate)	Přidá delegáta middlewaru terminálu do kanálu požadavků aplikace.
UseSession(IApplicationBuilder)	Přidá k SessionMiddleware automatickému povolení stavu relace pro aplikaci.
UseSession(IApplicationBuilder, SessionOptions)	Přidá k SessionMiddleware automatickému povolení stavu relace pro aplikaci.
UseSpa(IApplicationBuilder, Action<ISpaBuilder>)	Zpracovává všechny požadavky od tohoto okamžiku v řetězu middlewaru tak, že vrátí výchozí stránku jednostránkové aplikace (SPA). Tento middleware by se měl do řetězce umístit pozdě, aby měl přednost jiný middleware pro obsluhu statických souborů, akcí MVC atd.
UseStaticFiles(IApplicationBuilder)	Povolí statický soubor obsluhující aktuální cestu požadavku.
UseStaticFiles(IApplicationBuilder, StaticFileOptions)	Povolí statický soubor obsluhující s danými možnostmi.
UseStaticFiles(IApplicationBuilder, String)	Povolí statický soubor obsluhující 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ý kontroluje 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 kanálem middlewaru, který se spustí a vygeneruje tělo 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 k odeslání. To může obsahovat zástupný symbol pro{0} stavový kód. Middleware kontroluje odpovědi se stavovými kódy mezi 400 a 599, které nemají tělo.
UseStatusCodePagesWithRedirects(IApplicationBuilder, String)	Přidá do kanálu middleware StatusCodePages. Určuje, že odpovědi by měly být zpracovány přesměrováním pomocí dané šablony adresy URL umístění. To může obsahovat zástupný symbol pro{0} stavový kód. Adresy URL začínající na ~budou mít předpřisazení PathBase, kde se všechny ostatní adresy URL použijí tak, jak jsou.
UseStatusCodePagesWithReExecute(IApplicationBuilder, String, String)	Přidá do kanálu middleware StatusCodePages. Určuje, že tělo odpovědi by se mělo vygenerovat opětovným spuštěním kanálu požadavku pomocí alternativní cesty. Tato cesta může obsahovat{0} zástupný symbol stavového kódu.
Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>)	Přidá delegát middlewaru definovaný v řádku do kanálu žádosti aplikace. Pokud nevoláte další funkci, použijte místo toho příkaz Run(IApplicationBuilder, RequestDelegate) .
Use(IApplicationBuilder, Func<HttpContext,Func<Task>,Task>)	Přidá delegát middlewaru definovaný v řádku do kanálu žádosti aplikace. Pokud nevoláte další funkci, použijte místo toho příkaz Run(IApplicationBuilder, RequestDelegate) . Upřednostněte použití pro Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>) 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 zadaný základ cesty z cesty požadavku a odešle ho do základu cesty požadavku.
UseWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Podmíněně vytvoří větev v kanálu žádosti, 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 Chromium vývojových nástrojů.
UseWebSockets(IApplicationBuilder)	Přidá do WebSocketMiddleware kanálu žádosti .
UseWebSockets(IApplicationBuilder, WebSocketOptions)	Přidá do WebSocketMiddleware kanálu žádosti .
UseWelcomePage(IApplicationBuilder)	Přidá WelcomePageMiddleware do kanálu.
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 příchozí middleware protokolování požadavků HTTP v nástroji IApplicationBuilder.
UseRequestCheckpoint(IApplicationBuilder)	Zaregistruje do kanálu middlewary související s kontrolními body požadavků.
UseRequestLatencyTelemetry(IApplicationBuilder)	Přidá middleware telemetrie latence požadavků do IApplicationBuilder kanálu provádění požadavků.
UseSpaStaticFiles(IApplicationBuilder)	Nakonfiguruje aplikaci tak, aby obsluha statických souborů pro jednostránkovou aplikaci (SPA). Soubory se budou nacházet pomocí registrované ISpaStaticFileProvider služby.
UseSpaStaticFiles(IApplicationBuilder, StaticFileOptions)	Nakonfiguruje aplikaci tak, aby obsluha statických souborů pro jednostránkovou aplikaci (SPA). Soubory se budou nacházet pomocí registrované ISpaStaticFileProvider služby.