IApplicationBuilder Interfaccia

Definizione

Spazio dei nomi:

Microsoft.AspNetCore.Builder

Assembly:

Microsoft.AspNetCore.Http.Abstractions.dll

Pacchetto:

Microsoft.AspNetCore.App.Ref v8.0.0

Origine:

IApplicationBuilder.cs

Definisce una classe che fornisce i meccanismi per configurare la pipeline di richiesta di un'applicazione.

public interface class IApplicationBuilder

public interface IApplicationBuilder

type IApplicationBuilder = interface

Public Interface IApplicationBuilder

Derivato

Microsoft.AspNetCore.Builder.ApplicationBuilder

Microsoft.AspNetCore.Builder.WebApplication

Microsoft.AspNetCore.MiddlewareAnalysis.AnalysisBuilder

Proprietà

ApplicationServices	Ottiene o imposta la IServiceProvider che fornisce l'accesso al contenitore del servizio dell'applicazione.
Properties	Ottiene una raccolta chiave/valore che può essere utilizzata per condividere i dati tra middleware.
ServerFeatures	Ottiene il set di funzionalità HTTP fornite dal server dell'applicazione.

Metodi

Build()	Compila il delegato usato da questa applicazione per elaborare le richieste HTTP.
New()	Crea una nuova IApplicationBuilder che condivide il Properties di questo IApplicationBuilder.
Use(Func<RequestDelegate,RequestDelegate>)	Aggiunge un delegato middleware alla pipeline di richiesta dell'applicazione.

Metodi di estensione

UseAntiforgery(IApplicationBuilder)	Aggiunge il middleware anti-falso alla pipeline.
UseRequestLocalization(IApplicationBuilder)	Aggiunge il RequestLocalizationMiddleware per impostare automaticamente le informazioni sulle impostazioni cultura per le richieste in base alle informazioni fornite dal client.
UseRequestLocalization(IApplicationBuilder, RequestLocalizationOptions)	Aggiunge il RequestLocalizationMiddleware per impostare automaticamente le informazioni sulle impostazioni cultura per le richieste in base alle informazioni fornite dal client.
UseRequestLocalization(IApplicationBuilder, Action<RequestLocalizationOptions>)	Aggiunge il RequestLocalizationMiddleware per impostare automaticamente le informazioni sulle impostazioni cultura per le richieste in base alle informazioni fornite dal client.
UseRequestLocalization(IApplicationBuilder, String[])	Aggiunge il RequestLocalizationMiddleware per impostare automaticamente le informazioni sulle impostazioni cultura per le richieste in base alle informazioni fornite dal client.
UseAuthentication(IApplicationBuilder)	Aggiunge il AuthenticationMiddleware all'IApplicationBuilderspecificato, che abilita le funzionalità di autenticazione.
UseAuthorization(IApplicationBuilder)	Aggiunge il AuthorizationMiddleware all'IApplicationBuilderspecificato, che abilita le funzionalità di autorizzazione. Quando si autorizza una risorsa indirizzata tramite il routing degli endpoint, questa chiamata deve essere visualizzata tra le chiamate a app.UseRouting() e app.UseEndpoints(...) affinché il middleware funzioni correttamente.
UseCertificateForwarding(IApplicationBuilder)	Aggiunge un middleware alla pipeline che cercherà un certificato in un'intestazione di richiesta decodificarlo e aggiorna HttpContext.Connection.ClientCertificate.
UseBlazorFrameworkFiles(IApplicationBuilder)	Configura l'applicazione per gestire i file del framework Blazor WebAssembly dal percorso radice "/".
UseBlazorFrameworkFiles(IApplicationBuilder, PathString)	Configura l'applicazione per gestire i file del framework Blazor WebAssembly dal percorso pathPrefix. Questo percorso deve corrispondere a un progetto di applicazione Blazor WebAssembly di riferimento.
UseConcurrencyLimiter(IApplicationBuilder)	Obsoleti. Aggiunge il ConcurrencyLimiterMiddleware per limitare il numero di richieste in esecuzione simultanea.
UseCookiePolicy(IApplicationBuilder)	Aggiunge il gestore CookiePolicyMiddleware all'IApplicationBuilderspecificato, che abilita le funzionalità dei criteri dei cookie.
UseCookiePolicy(IApplicationBuilder, CookiePolicyOptions)	Aggiunge il gestore CookiePolicyMiddleware all'IApplicationBuilderspecificato, che abilita le funzionalità dei criteri dei cookie.
UseCors(IApplicationBuilder)	Aggiunge un middleware CORS alla pipeline dell'applicazione Web per consentire le richieste tra domini.
UseCors(IApplicationBuilder, Action<CorsPolicyBuilder>)	Aggiunge un middleware CORS alla pipeline dell'applicazione Web per consentire le richieste tra domini.
UseCors(IApplicationBuilder, String)	Aggiunge un middleware CORS alla pipeline dell'applicazione Web per consentire le richieste tra domini.
UseDatabaseErrorPage(IApplicationBuilder)	Obsoleti. Acquisisce le eccezioni sincrone e asincrone correlate al database dalla pipeline che possono essere risolte usando le migrazioni di Entity Framework. Quando si verificano queste eccezioni, viene generata una risposta HTML con i dettagli delle possibili azioni per risolvere il problema.
UseDatabaseErrorPage(IApplicationBuilder, DatabaseErrorPageOptions)	Obsoleti. Acquisisce le eccezioni sincrone e asincrone correlate al database dalla pipeline che possono essere risolte usando le migrazioni di Entity Framework. Quando si verificano queste eccezioni, viene generata una risposta HTML con i dettagli delle possibili azioni per risolvere il problema.
UseDefaultFiles(IApplicationBuilder)	Abilita il mapping dei file predefinito nel percorso corrente
UseDefaultFiles(IApplicationBuilder, DefaultFilesOptions)	Abilita il mapping dei file predefinito con le opzioni specificate
UseDefaultFiles(IApplicationBuilder, String)	Abilita il mapping dei file predefinito per il percorso della richiesta specificato
UseDeveloperExceptionPage(IApplicationBuilder)	Acquisisce istanze sincrone e asincrone Exception dalla pipeline e genera risposte di errore HTML.
UseDeveloperExceptionPage(IApplicationBuilder, DeveloperExceptionPageOptions)	Acquisisce istanze sincrone e asincrone Exception dalla pipeline e genera risposte di errore HTML.
UseDirectoryBrowser(IApplicationBuilder)	Abilitare l'esplorazione della directory nel percorso corrente
UseDirectoryBrowser(IApplicationBuilder, DirectoryBrowserOptions)	Abilitare l'esplorazione della directory con le opzioni specificate
UseDirectoryBrowser(IApplicationBuilder, String)	Abilita l'esplorazione della directory per il percorso della richiesta specificato
UseEndpoints(IApplicationBuilder, Action<IEndpointRouteBuilder>)	Aggiunge un middleware Microsoft.AspNetCore.Routing.EndpointMiddleware all'IApplicationBuilder specificato con le istanze di EndpointDataSource create da IEndpointRouteBuilderconfigurate. Il Microsoft.AspNetCore.Routing.EndpointMiddleware eseguirà il Endpoint associato alla richiesta corrente.
UseRouting(IApplicationBuilder)	Aggiunge un middleware Microsoft.AspNetCore.Routing.EndpointRoutingMiddleware al IApplicationBuilderspecificato.
UseExceptionHandler(IApplicationBuilder)	Aggiunge un middleware alla pipeline che intercetta le eccezioni, le registra e esegue di nuovo la richiesta in una pipeline alternativa. La richiesta non verrà nuovamente eseguita se la risposta è già stata avviata.
UseExceptionHandler(IApplicationBuilder, ExceptionHandlerOptions)	Aggiunge un middleware alla pipeline che intercetta le eccezioni, le registra e esegue di nuovo la richiesta in una pipeline alternativa. La richiesta non verrà nuovamente eseguita se la risposta è già stata avviata.
UseExceptionHandler(IApplicationBuilder, Action<IApplicationBuilder>)	Aggiunge un middleware alla pipeline che intercetta le eccezioni, le registra e esegue di nuovo la richiesta in una pipeline alternativa. La richiesta non verrà nuovamente eseguita se la risposta è già stata avviata.
UseExceptionHandler(IApplicationBuilder, String)	Aggiunge un middleware alla pipeline che intercetta le eccezioni, le registra, reimposta il percorso della richiesta ed esegue di nuovo la richiesta. La richiesta non verrà nuovamente eseguita se la risposta è già stata avviata.
UseExceptionHandler(IApplicationBuilder, String, Boolean)	Aggiunge un middleware alla pipeline che intercetta le eccezioni, le registra, reimposta il percorso della richiesta ed esegue di nuovo la richiesta. La richiesta non verrà nuovamente eseguita se la risposta è già stata avviata.
UseFileServer(IApplicationBuilder)	Abilitare tutto il middleware dei file statici (ad eccezione dell'esplorazione della directory) per il percorso della richiesta corrente nella directory corrente.
UseFileServer(IApplicationBuilder, FileServerOptions)	Abilitare tutto il middleware di file statico con le opzioni specificate
UseFileServer(IApplicationBuilder, Boolean)	Abilitare tutto il middleware dei file statici per il percorso della richiesta corrente nella directory corrente.
UseFileServer(IApplicationBuilder, String)	Abilita tutto il middleware di file statico (ad eccezione dell'esplorazione della directory) per il percorso della richiesta specificato dalla directory con lo stesso nome
UseForwardedHeaders(IApplicationBuilder)	Applica le intestazioni inoltrate ai campi corrispondenti nella richiesta corrente. Per convenzione, i proxy HTTP inoltrano informazioni dal client in intestazioni HTTP note. Il ForwardedHeadersMiddleware legge queste intestazioni e compila i campi associati in HttpContext.
UseForwardedHeaders(IApplicationBuilder, ForwardedHeadersOptions)	Applica le intestazioni inoltrate ai campi corrispondenti nella richiesta corrente. Per convenzione, i proxy HTTP inoltrano informazioni dal client in intestazioni HTTP note. Il ForwardedHeadersMiddleware legge queste intestazioni e compila i campi associati in HttpContext.
UseHeaderPropagation(IApplicationBuilder)	Aggiunge un middleware che raccoglie le intestazioni da propagare a un HttpClient.
UseHealthChecks(IApplicationBuilder, PathString)	Aggiunge un middleware che fornisce lo stato del controllo integrità.
UseHealthChecks(IApplicationBuilder, PathString, HealthCheckOptions)	Aggiunge un middleware che fornisce lo stato del controllo integrità.
UseHealthChecks(IApplicationBuilder, PathString, Int32)	Aggiunge un middleware che fornisce lo stato del controllo integrità.
UseHealthChecks(IApplicationBuilder, PathString, Int32, HealthCheckOptions)	Aggiunge un middleware che fornisce lo stato del controllo integrità.
UseHealthChecks(IApplicationBuilder, PathString, String)	Aggiunge un middleware che fornisce lo stato del controllo integrità.
UseHealthChecks(IApplicationBuilder, PathString, String, HealthCheckOptions)	Aggiunge un middleware che fornisce lo stato del controllo integrità.
UseHostFiltering(IApplicationBuilder)	Aggiunge middleware per filtrare le richieste in base alle intestazioni host consentite. Le richieste non valide verranno rifiutate con un codice di stato 400.
UseHsts(IApplicationBuilder)	Aggiunge il middleware per l'uso di HSTS, che aggiunge l'intestazione Strict-Transport-Security.
UseHttpLogging(IApplicationBuilder)	Aggiunge un middleware in grado di registrare richieste e risposte HTTP.
UseW3CLogging(IApplicationBuilder)	Aggiunge un middleware in grado di registrare richieste HTTP e risposte per i log del server in formato W3C.
UseHttpMethodOverride(IApplicationBuilder)	Consente alla richiesta POST in ingresso di eseguire l'override del tipo di metodo con il tipo specificato nell'intestazione. Questo middleware viene usato quando un client è limitato all'invio di metodi GET o POST, ma vuole richiamare altri metodi HTTP. Per impostazione predefinita, l'intestazione della richiesta X-HTTP-Method-Override viene usata per specificare il metodo HTTP sottoposto a tunneling.
UseHttpMethodOverride(IApplicationBuilder, HttpMethodOverrideOptions)	Consente alla richiesta POST in ingresso di eseguire l'override del tipo di metodo con il tipo specificato nel modulo. Questo middleware viene usato quando un client è limitato all'invio di metodi GET o POST, ma vuole richiamare altri metodi HTTP.
UseHttpsRedirection(IApplicationBuilder)	Aggiunge middleware per il reindirizzamento delle richieste HTTP a HTTPS.
Map(IApplicationBuilder, PathString, Action<IApplicationBuilder>)	Crea un ramo della pipeline di richiesta in base alle corrispondenze del percorso della richiesta specificato. Se il percorso della richiesta inizia con il percorso specificato, il ramo viene eseguito.
Map(IApplicationBuilder, PathString, Boolean, Action<IApplicationBuilder>)	Crea un ramo della pipeline di richiesta in base alle corrispondenze del percorso della richiesta specificato. Se il percorso della richiesta inizia con il percorso specificato, il ramo viene eseguito.
Map(IApplicationBuilder, String, Action<IApplicationBuilder>)	Crea un ramo della pipeline di richiesta in base alle corrispondenze del percorso della richiesta specificato. Se il percorso della richiesta inizia con il percorso specificato, il ramo viene eseguito.
MapWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Crea un ramo della pipeline di richiesta in base al risultato del predicato specificato.
UseMigrationsEndPoint(IApplicationBuilder)	Elabora le richieste per eseguire operazioni di migrazione. Il middleware sarà in ascolto delle richieste effettuate a DefaultPath.
UseMigrationsEndPoint(IApplicationBuilder, MigrationsEndPointOptions)	Elabora le richieste per eseguire operazioni di migrazione. Il middleware sarà in ascolto delle richieste al percorso configurato in options.
UseMvc(IApplicationBuilder)	Aggiunge MVC alla pipeline di esecuzione della richiesta IApplicationBuilder.
UseMvc(IApplicationBuilder, Action<IRouteBuilder>)	Aggiunge MVC alla pipeline di esecuzione della richiesta IApplicationBuilder.
UseMvcWithDefaultRoute(IApplicationBuilder)	Aggiunge MVC alla pipeline di esecuzione delle richieste IApplicationBuilder con una route predefinita denominata 'default' e il modello seguente: '{controller=Home}/{action=Index}/{id?}'.
UseOutputCache(IApplicationBuilder)	Aggiunge il Microsoft.AspNetCore.OutputCaching.OutputCacheMiddleware per la memorizzazione nella cache delle risposte HTTP.
UseOwin(IApplicationBuilder)	Aggiunge una pipeline OWIN al IApplicationBuilderspecificato.
UseOwin(IApplicationBuilder, Action<Action<Func<Func<IDictionary<String,Object>,Task>,Func<IDictionary<String,Object>,Task>>>>)	Aggiunge la pipeline middleware OWIN alla IApplicationBuilderspecificata.
UseRateLimiter(IApplicationBuilder)	Abilita la limitazione della frequenza per l'applicazione.
UseRateLimiter(IApplicationBuilder, RateLimiterOptions)	Abilita la limitazione della frequenza per l'applicazione.
UseRequestDecompression(IApplicationBuilder)	Aggiunge middleware per decomprimere dinamicamente i corpi delle richieste HTTP.
UseRequestTimeouts(IApplicationBuilder)	Abilita i timeout delle richieste per l'applicazione. Per impostazione predefinita, non sono configurati timeout. Devono essere configurati in RequestTimeoutOptions, il RequestTimeoutAttribute negli endpoint o usando le estensioni di routing WithRequestTimeout.
UseResponseCaching(IApplicationBuilder)	Aggiunge il ResponseCachingMiddleware per la memorizzazione nella cache delle risposte HTTP.
UseResponseCompression(IApplicationBuilder)	Aggiunge middleware per la compressione dinamica delle risposte HTTP.
UseRewriter(IApplicationBuilder)	Controlla se un url specificato corrisponde a regole e condizioni e modifica httpContext in corrispondenza.
UseRewriter(IApplicationBuilder, RewriteOptions)	Controlla se un url specificato corrisponde a regole e condizioni e modifica httpContext in corrispondenza.
UseRouter(IApplicationBuilder, IRouter)	Aggiunge un middleware RouterMiddleware all'IApplicationBuilder specificato con il IRouterspecificato.
UseRouter(IApplicationBuilder, Action<IRouteBuilder>)	Aggiunge un middleware RouterMiddleware all'IApplicationBuilder specificato con il IRouter compilato da IRouteBuilderconfigurato.
Run(IApplicationBuilder, RequestDelegate)	Aggiunge un delegato middleware del terminale alla pipeline di richiesta dell'applicazione.
UseSession(IApplicationBuilder)	Aggiunge il SessionMiddleware per abilitare automaticamente lo stato della sessione per l'applicazione.
UseSession(IApplicationBuilder, SessionOptions)	Aggiunge il SessionMiddleware per abilitare automaticamente lo stato della sessione per l'applicazione.
UseSpa(IApplicationBuilder, Action<ISpaBuilder>)	Gestisce tutte le richieste da questo punto nella catena middleware restituendo la pagina predefinita per l'applicazione a pagina singola . Questo middleware deve essere inserito in ritardo nella catena, in modo che altri middleware per la gestione di file statici, azioni MVC e così via, hanno la precedenza.
UseStaticFiles(IApplicationBuilder)	Abilita la gestione di file statici per il percorso della richiesta corrente
UseStaticFiles(IApplicationBuilder, StaticFileOptions)	Abilita la gestione di file statici con le opzioni specificate
UseStaticFiles(IApplicationBuilder, String)	Abilita la gestione di file statici per il percorso della richiesta specificato
UseStatusCodePages(IApplicationBuilder)	Aggiunge un middleware StatusCodePages con un gestore di risposta predefinito che controlla le risposte con codici di stato compresi tra 400 e 599 che non hanno un corpo.
UseStatusCodePages(IApplicationBuilder, StatusCodePagesOptions)	Aggiunge un middleware StatusCodePages con le opzioni specificate che controllano le risposte con codici di stato compresi tra 400 e 599 che non hanno un corpo.
UseStatusCodePages(IApplicationBuilder, Action<IApplicationBuilder>)	Aggiunge un middleware StatusCodePages alla pipeline con la pipeline middleware alternativa specificata da eseguire per generare il corpo della risposta.
UseStatusCodePages(IApplicationBuilder, Func<StatusCodeContext,Task>)	Aggiunge un middleware StatusCodePages con il gestore specificato che verifica la presenza di risposte con codici di stato compresi tra 400 e 599 che non hanno un corpo.
UseStatusCodePages(IApplicationBuilder, String, String)	Aggiunge un middleware StatusCodePages con il corpo della risposta specificato da inviare. Questo può includere un segnaposto "{0}" per il codice di stato. Il middleware verifica la presenza di risposte con codici di stato compresi tra 400 e 599 che non hanno un corpo.
UseStatusCodePagesWithRedirects(IApplicationBuilder, String)	Aggiunge un middleware StatusCodePages alla pipeline. Specifica che le risposte devono essere gestite reindirizzando con il modello di URL della posizione specificato. Questo può includere un segnaposto "{0}" per il codice di stato. Gli URL che iniziano con '~' avranno pathBase anteporre, dove qualsiasi altro URL verrà usato così come è.
UseStatusCodePagesWithReExecute(IApplicationBuilder, String, String)	Aggiunge un middleware StatusCodePages alla pipeline. Specifica che il corpo della risposta deve essere generato eseguendo nuovamente la pipeline della richiesta usando un percorso alternativo. Questo percorso può contenere un segnaposto '{0}' del codice di stato.
Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>)	Aggiunge un delegato middleware definito inline alla pipeline di richiesta dell'applicazione. Se non si chiama la funzione successiva, usare Run(IApplicationBuilder, RequestDelegate).
Use(IApplicationBuilder, Func<HttpContext,Func<Task>,Task>)	Aggiunge un delegato middleware definito inline alla pipeline di richiesta dell'applicazione. Se non si chiama la funzione successiva, usare Run(IApplicationBuilder, RequestDelegate). Preferire l'uso di Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>) per ottenere prestazioni migliori, come illustrato di seguito: app.Use((context, next) => { return next(context); });
UseMiddleware(IApplicationBuilder, Type, Object[])	Aggiunge un tipo middleware alla pipeline di richiesta dell'applicazione.
UseMiddleware<TMiddleware>(IApplicationBuilder, Object[])	Aggiunge un tipo middleware alla pipeline di richiesta dell'applicazione.
UsePathBase(IApplicationBuilder, PathString)	Aggiunge un middleware che estrae la base di percorso specificata dal percorso della richiesta e lo antepone alla base del percorso della richiesta.
UseWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Crea in modo condizionale un ramo nella pipeline di richiesta che viene ricongiunnesso alla pipeline principale.
UseWebAssemblyDebugging(IApplicationBuilder)	Aggiunge il middleware necessario per il debug di applicazioni WebAssembly Blazor all'interno degli strumenti di sviluppo Chromium.
UseWebSockets(IApplicationBuilder)	Aggiunge la WebSocketMiddleware alla pipeline di richiesta.
UseWebSockets(IApplicationBuilder, WebSocketOptions)	Aggiunge la WebSocketMiddleware alla pipeline di richiesta.
UseWelcomePage(IApplicationBuilder)	Aggiunge welcomePageMiddleware alla pipeline.
UseWelcomePage(IApplicationBuilder, WelcomePageOptions)	Aggiunge WelcomePageMiddleware alla pipeline con le opzioni specificate.
UseWelcomePage(IApplicationBuilder, PathString)	Aggiunge WelcomePageMiddleware alla pipeline con il percorso specificato.
UseWelcomePage(IApplicationBuilder, String)	Aggiunge WelcomePageMiddleware alla pipeline con il percorso specificato.
UseHttpLoggingMiddleware(IApplicationBuilder)	Registra il middleware di registrazione delle richieste HTTP in ingresso in IApplicationBuilder.
UseRequestCheckpoint(IApplicationBuilder)	Registra i middleware correlati al checkpoint della richiesta nella pipeline.
UseRequestLatencyTelemetry(IApplicationBuilder)	Aggiunge il middleware di telemetria della latenza della richiesta a IApplicationBuilder pipeline di esecuzione delle richieste.
UseSpaStaticFiles(IApplicationBuilder)	Configura l'applicazione per la gestione di file statici per un'applicazione a pagina singola. I file verranno posizionati usando il servizio di ISpaStaticFileProvider registrato.
UseSpaStaticFiles(IApplicationBuilder, StaticFileOptions)	Configura l'applicazione per la gestione di file statici per un'applicazione a pagina singola. I file verranno posizionati usando il servizio di ISpaStaticFileProvider registrato.