IApplicationBuilder Interfaccia

Definizione

Spazio dei nomi:

Microsoft.AspNetCore.Builder

Assembly:

Microsoft.AspNetCore.Http.Abstractions.dll

Pacchetto:

Microsoft.AspNetCore.App.Ref v8.0.0

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 l'oggetto che fornisce l'accesso IServiceProvider al contenitore del servizio dell'applicazione.
Properties	Ottiene una raccolta chiave/valore che può essere utilizzata per condividere 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 un nuovo IApplicationBuilder oggetto che condivide l'oggetto Properties di .IApplicationBuilder
Use(Func<RequestDelegate,RequestDelegate>)	Aggiunge un delegato middleware alla pipeline di richiesta dell'applicazione.

Metodi di estensione

UseAntiforgery(IApplicationBuilder)	Aggiunge il middleware antifalsificazione alla pipeline.
UseRequestLocalization(IApplicationBuilder)	Aggiunge per RequestLocalizationMiddleware impostare automaticamente le informazioni sulle impostazioni cultura per le richieste in base alle informazioni fornite dal client.
UseRequestLocalization(IApplicationBuilder, RequestLocalizationOptions)	Aggiunge per RequestLocalizationMiddleware impostare automaticamente le informazioni sulle impostazioni cultura per le richieste in base alle informazioni fornite dal client.
UseRequestLocalization(IApplicationBuilder, Action<RequestLocalizationOptions>)	Aggiunge per RequestLocalizationMiddleware impostare automaticamente le informazioni sulle impostazioni cultura per le richieste in base alle informazioni fornite dal client.
UseRequestLocalization(IApplicationBuilder, String[])	Aggiunge per RequestLocalizationMiddleware impostare automaticamente le informazioni sulle impostazioni cultura per le richieste in base alle informazioni fornite dal client.
UseAuthentication(IApplicationBuilder)	Aggiunge l'oggetto AuthenticationMiddleware all'oggetto specificato IApplicationBuilder, che abilita le funzionalità di autenticazione.
UseAuthorization(IApplicationBuilder)	Aggiunge l'oggetto AuthorizationMiddleware all'oggetto specificato IApplicationBuilder, 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(...) per il middleware per funzionare 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 in modo che gestisca i file del framework Blazor WebAssembly dal percorso radice "/".
UseBlazorFrameworkFiles(IApplicationBuilder, PathString)	Configura l'applicazione in modo che gestisca i file di framework Blazor WebAssembly dal percorso pathPrefix. Questo percorso deve corrispondere a un progetto di applicazione WebAssembly Blazor a cui si fa riferimento.
UseConcurrencyLimiter(IApplicationBuilder)	Obsoleti. Aggiunge per ConcurrencyLimiterMiddleware limitare il numero di richieste in esecuzione simultanea.
UseCookiePolicy(IApplicationBuilder)	Aggiunge il gestore all'oggetto CookiePolicyMiddleware specificato IApplicationBuilder, che abilita le funzionalità dei criteri dei cookie.
UseCookiePolicy(IApplicationBuilder, CookiePolicyOptions)	Aggiunge il gestore all'oggetto CookiePolicyMiddleware specificato IApplicationBuilder, 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 migrazioni di Entity Framework. Quando si verificano queste eccezioni, viene generata una risposta HTML con i dettagli delle azioni possibili per risolvere il problema.
UseDatabaseErrorPage(IApplicationBuilder, DatabaseErrorPageOptions)	Obsoleti. Acquisisce le eccezioni sincrone e asincrone correlate al database dalla pipeline che possono essere risolte usando migrazioni di Entity Framework. Quando si verificano queste eccezioni, viene generata una risposta HTML con i dettagli delle azioni possibili per risolvere il problema.
UseDefaultFiles(IApplicationBuilder)	Abilita il mapping dei file predefinito nel percorso corrente
UseDefaultFiles(IApplicationBuilder, DefaultFilesOptions)	Abilita il mapping del file predefinito con le opzioni specificate
UseDefaultFiles(IApplicationBuilder, String)	Abilita il mapping di 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 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 Microsoft.AspNetCore.Routing.EndpointMiddleware middleware all'oggetto specificato IApplicationBuilder con le EndpointDataSource istanze compilate da configurate IEndpointRouteBuilder. Verrà Microsoft.AspNetCore.Routing.EndpointMiddleware eseguito l'oggetto Endpoint associato alla richiesta corrente.
UseRouting(IApplicationBuilder)	Aggiunge un Microsoft.AspNetCore.Routing.EndpointRoutingMiddleware middleware all'oggetto specificato IApplicationBuilder.
UseExceptionHandler(IApplicationBuilder)	Aggiunge un middleware alla pipeline che intercetta le eccezioni, le registra ed esegue di nuovo la richiesta in una pipeline alternativa. La richiesta non verrà eseguita nuovamente se la risposta è già stata avviata.
UseExceptionHandler(IApplicationBuilder, ExceptionHandlerOptions)	Aggiunge un middleware alla pipeline che intercetta le eccezioni, le registra ed esegue di nuovo la richiesta in una pipeline alternativa. La richiesta non verrà eseguita nuovamente se la risposta è già stata avviata.
UseExceptionHandler(IApplicationBuilder, Action<IApplicationBuilder>)	Aggiunge un middleware alla pipeline che intercetta le eccezioni, le registra ed esegue di nuovo la richiesta in una pipeline alternativa. La richiesta non verrà eseguita nuovamente se la risposta è già stata avviata.
UseExceptionHandler(IApplicationBuilder, String)	Aggiunge un middleware alla pipeline che intercetta le eccezioni, li registra, reimposta il percorso della richiesta ed esegue di nuovo la richiesta. La richiesta non verrà eseguita nuovamente se la risposta è già stata avviata.
UseExceptionHandler(IApplicationBuilder, String, Boolean)	Aggiunge un middleware alla pipeline che intercetta le eccezioni, li registra, reimposta il percorso della richiesta ed esegue di nuovo la richiesta. La richiesta non verrà eseguita nuovamente se la risposta è già stata avviata.
UseFileServer(IApplicationBuilder)	Abilitare il middleware di tutti file statici (tranne l'esplorazione directory) per il percorso di richiesta corrente nella directory corrente.
UseFileServer(IApplicationBuilder, FileServerOptions)	Abilitare il middleware di tutti file statici con le opzioni specificate
UseFileServer(IApplicationBuilder, Boolean)	Abilitare il middleware di tutti file statici per il percorso di richiesta corrente nella directory corrente.
UseFileServer(IApplicationBuilder, String)	Abilita il middleware di tutti file statici (tranne l'esplorazione directory) per il percorso di 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 le informazioni dal client in intestazioni HTTP note. Legge ForwardedHeadersMiddleware 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 le informazioni dal client in intestazioni HTTP note. Legge ForwardedHeadersMiddleware queste intestazioni e compila i campi associati in HttpContext.
UseHeaderPropagation(IApplicationBuilder)	Aggiunge un middleware che raccoglie le intestazioni da propagare a un oggetto 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 e risposte HTTP 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>)	Ramifica la pipeline della richiesta in base al risultato del predicato specificato.
UseMigrationsEndPoint(IApplicationBuilder)	Elabora le richieste di esecuzione delle operazioni di migrazione. Il middleware sarà in ascolto delle richieste effettuate a DefaultPath.
UseMigrationsEndPoint(IApplicationBuilder, MigrationsEndPointOptions)	Elabora le richieste di esecuzione delle operazioni di migrazione. Il middleware sarà in ascolto delle richieste al percorso configurato in options.
UseMvc(IApplicationBuilder)	Aggiunge MVC alla pipeline di esecuzione della IApplicationBuilder richiesta.
UseMvc(IApplicationBuilder, Action<IRouteBuilder>)	Aggiunge MVC alla pipeline di esecuzione della IApplicationBuilder richiesta.
UseMvcWithDefaultRoute(IApplicationBuilder)	Aggiunge MVC alla pipeline di esecuzione della IApplicationBuilder richiesta con una route predefinita denominata 'default' e il modello seguente: '{controller=Home}/{action=Index}/{id?}'.
UseOutputCache(IApplicationBuilder)	Definisce una classe che fornisce i meccanismi per configurare la pipeline di richiesta di un'applicazione.
UseOwin(IApplicationBuilder)	Aggiunge una pipeline OWIN all'oggetto specificato IApplicationBuilder.
UseOwin(IApplicationBuilder, Action<Action<Func<Func<IDictionary<String,Object>,Task>,Func<IDictionary<String,Object>,Task>>>>)	Aggiunge la pipeline middleware OWIN all'oggetto specificato IApplicationBuilder.
UseRateLimiter(IApplicationBuilder)	Abilita la limitazione della velocità per l'applicazione.
UseRateLimiter(IApplicationBuilder, RateLimiterOptions)	Abilita la limitazione della velocità per l'applicazione.
UseRequestDecompression(IApplicationBuilder)	Aggiunge middleware per decomprimere dinamicamente i corpi di richiesta HTTP.
UseRequestTimeouts(IApplicationBuilder)	Abilita i timeout delle richieste per l'applicazione. Per impostazione predefinita, non sono configurati timeout. Devono essere configurati in RequestTimeoutOptions, negli RequestTimeoutAttribute endpoint o usando le estensioni di routing WithRequestTimeout.
UseResponseCaching(IApplicationBuilder)	Aggiunge per la memorizzazione nella ResponseCachingMiddleware 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 RouterMiddleware middleware all'oggetto specificato IApplicationBuilder con l'oggetto specificato IRouter.
UseRouter(IApplicationBuilder, Action<IRouteBuilder>)	Aggiunge un RouterMiddleware middleware all'oggetto specificato IApplicationBuilder con l'oggetto IRouter compilato da configurato IRouteBuilder.
Run(IApplicationBuilder, RequestDelegate)	Aggiunge un delegato middleware del terminale alla pipeline di richiesta dell'applicazione.
UseSession(IApplicationBuilder)	Aggiunge per SessionMiddleware abilitare automaticamente lo stato della sessione per l'applicazione.
UseSession(IApplicationBuilder, SessionOptions)	Aggiunge per SessionMiddleware 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 dei file statici per il percorso della richiesta corrente
UseStaticFiles(IApplicationBuilder, StaticFileOptions)	Abilita la gestione dei file statici con le opzioni specificate
UseStaticFiles(IApplicationBuilder, String)	Abilita la gestione dei file statici per il percorso della richiesta specificato
UseStatusCodePages(IApplicationBuilder)	Aggiunge un middleware StatusCodePages con un gestore di risposta predefinito che verifica la presenza di 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 controlla 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. 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. Può includere un segnaposto '{0}' per il codice di stato. Gli URL che iniziano con '~' avranno pathBase prependato, dove qualsiasi altro URL verrà usato come è.
UseStatusCodePagesWithReExecute(IApplicationBuilder, String, String)	Aggiunge un middleware StatusCodePages alla pipeline. Specifica che il corpo della risposta deve essere generato eseguendo nuovamente la pipeline delle richieste con 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 in riga alla pipeline di richiesta dell'applicazione. Se non si chiama la funzione successiva, usare Run(IApplicationBuilder, RequestDelegate) invece.
Use(IApplicationBuilder, Func<HttpContext,Func<Task>,Task>)	Aggiunge un delegato middleware definito in riga alla pipeline di richiesta dell'applicazione. Se non si chiama la funzione successiva, usare Run(IApplicationBuilder, RequestDelegate) invece. Preferisce usare Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>) per migliorare le prestazioni, 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 del percorso specificato dal percorso della richiesta e lo ha postpendato 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 ricongiunnessa alla pipeline principale.
UseWebAssemblyDebugging(IApplicationBuilder)	Aggiunge il middleware necessario per il debug di applicazioni Blazor WebAssembly all'interno di Chromium strumenti di sviluppo.
UseWebSockets(IApplicationBuilder)	Aggiunge l'oggetto WebSocketMiddleware alla pipeline della richiesta.
UseWebSockets(IApplicationBuilder, WebSocketOptions)	Aggiunge l'oggetto WebSocketMiddleware alla pipeline della 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 della 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 per IApplicationBuilder richiedere la pipeline di esecuzione.
UseSpaStaticFiles(IApplicationBuilder)	Configura l'applicazione per gestire i file statici per un'applicazione a pagina singola . I file si trovano usando il servizio registrato ISpaStaticFileProvider .
UseSpaStaticFiles(IApplicationBuilder, StaticFileOptions)	Configura l'applicazione per gestire i file statici per un'applicazione a pagina singola . I file si trovano usando il servizio registrato ISpaStaticFileProvider .