IApplicationBuilder Interface

Definição

Namespace:

Microsoft.AspNetCore.Builder

Assembly:

Microsoft.AspNetCore.Http.Abstractions.dll

Pacote:

Microsoft.AspNetCore.App.Ref v8.0.0

Origem:

IApplicationBuilder.cs

Define uma classe que fornece os mecanismos para configurar o pipeline de solicitação de um aplicativo.

public interface class IApplicationBuilder

public interface IApplicationBuilder

type IApplicationBuilder = interface

Public Interface IApplicationBuilder

Derivado

Microsoft.AspNetCore.Builder.ApplicationBuilder

Microsoft.AspNetCore.Builder.WebApplication

Microsoft.AspNetCore.MiddlewareAnalysis.AnalysisBuilder

Propriedades

ApplicationServices	Obtém ou define o IServiceProvider que fornece acesso ao contêiner de serviço do aplicativo.
Properties	Obtém uma coleção de chave/valor que pode ser usada para compartilhar dados entre middleware.
ServerFeatures	Obtém o conjunto de recursos HTTP que o servidor do aplicativo fornece.

Métodos

Build()	Cria o delegado usado por este aplicativo para processar solicitações HTTP.
New()	Cria um novo IApplicationBuilder que compartilha o Properties deste IApplicationBuilder.
Use(Func<RequestDelegate,RequestDelegate>)	Adiciona um delegado de middleware ao pipeline de solicitação do aplicativo.

Métodos de Extensão

UseAntiforgery(IApplicationBuilder)	Adiciona o middleware anti-falsificação ao pipeline.
UseRequestLocalization(IApplicationBuilder)	Adiciona o RequestLocalizationMiddleware para definir automaticamente informações de cultura para solicitações com base nas informações fornecidas pelo cliente.
UseRequestLocalization(IApplicationBuilder, RequestLocalizationOptions)	Adiciona o RequestLocalizationMiddleware para definir automaticamente informações de cultura para solicitações com base nas informações fornecidas pelo cliente.
UseRequestLocalization(IApplicationBuilder, Action<RequestLocalizationOptions>)	Adiciona o RequestLocalizationMiddleware para definir automaticamente informações de cultura para solicitações com base nas informações fornecidas pelo cliente.
UseRequestLocalization(IApplicationBuilder, String[])	Adiciona o RequestLocalizationMiddleware para definir automaticamente informações de cultura para solicitações com base nas informações fornecidas pelo cliente.
UseAuthentication(IApplicationBuilder)	Adiciona o AuthenticationMiddleware ao IApplicationBuilderespecificado, que permite recursos de autenticação.
UseAuthorization(IApplicationBuilder)	Adiciona o AuthorizationMiddleware ao IApplicationBuilderespecificado, que permite recursos de autorização. Ao autorizar um recurso roteado usando o roteamento de ponto de extremidade, essa chamada deve aparecer entre as chamadas para app.UseRouting() e app.UseEndpoints(...) para que o middleware funcione corretamente.
UseCertificateForwarding(IApplicationBuilder)	Adiciona um middleware ao pipeline que procurará um certificado em um cabeçalho de solicitação decodificá-lo e atualiza HttpContext.Connection.ClientCertificate.
UseBlazorFrameworkFiles(IApplicationBuilder)	Configura o aplicativo para servir arquivos de estrutura Do Blazor WebAssembly do caminho raiz "/".
UseBlazorFrameworkFiles(IApplicationBuilder, PathString)	Configura o aplicativo para fornecer arquivos de estrutura Do Blazor WebAssembly do caminho pathPrefix. Esse caminho deve corresponder a um projeto de aplicativo Blazor WebAssembly referenciado.
UseConcurrencyLimiter(IApplicationBuilder)	Obsoleto. Adiciona o ConcurrencyLimiterMiddleware para limitar o número de solicitações que executam simultaneamente.
UseCookiePolicy(IApplicationBuilder)	Adiciona o manipulador de CookiePolicyMiddleware ao IApplicationBuilderespecificado, que permite recursos de política de cookie.
UseCookiePolicy(IApplicationBuilder, CookiePolicyOptions)	Adiciona o manipulador de CookiePolicyMiddleware ao IApplicationBuilderespecificado, que permite recursos de política de cookie.
UseCors(IApplicationBuilder)	Adiciona um middleware CORS ao pipeline do aplicativo Web para permitir solicitações entre domínios.
UseCors(IApplicationBuilder, Action<CorsPolicyBuilder>)	Adiciona um middleware CORS ao pipeline do aplicativo Web para permitir solicitações entre domínios.
UseCors(IApplicationBuilder, String)	Adiciona um middleware CORS ao pipeline do aplicativo Web para permitir solicitações entre domínios.
UseDatabaseErrorPage(IApplicationBuilder)	Obsoleto. Captura exceções síncronas e assíncronas relacionadas ao banco de dados do pipeline que podem ser resolvidas usando migrações do Entity Framework. Quando essas exceções ocorrem, uma resposta HTML com detalhes de possíveis ações para resolver o problema é gerada.
UseDatabaseErrorPage(IApplicationBuilder, DatabaseErrorPageOptions)	Obsoleto. Captura exceções síncronas e assíncronas relacionadas ao banco de dados do pipeline que podem ser resolvidas usando migrações do Entity Framework. Quando essas exceções ocorrem, uma resposta HTML com detalhes de possíveis ações para resolver o problema é gerada.
UseDefaultFiles(IApplicationBuilder)	Habilita o mapeamento de arquivo padrão no caminho atual
UseDefaultFiles(IApplicationBuilder, DefaultFilesOptions)	Habilita o mapeamento de arquivo padrão com as opções fornecidas
UseDefaultFiles(IApplicationBuilder, String)	Habilita o mapeamento de arquivo padrão para o caminho de solicitação fornecido
UseDeveloperExceptionPage(IApplicationBuilder)	Captura instâncias de Exception síncronas e assíncronas do pipeline e gera respostas de erro HTML.
UseDeveloperExceptionPage(IApplicationBuilder, DeveloperExceptionPageOptions)	Captura instâncias de Exception síncronas e assíncronas do pipeline e gera respostas de erro HTML.
UseDirectoryBrowser(IApplicationBuilder)	Habilitar a navegação de diretório no caminho atual
UseDirectoryBrowser(IApplicationBuilder, DirectoryBrowserOptions)	Habilitar a navegação de diretório com as opções fornecidas
UseDirectoryBrowser(IApplicationBuilder, String)	Habilita a navegação de diretório para o caminho de solicitação fornecido
UseEndpoints(IApplicationBuilder, Action<IEndpointRouteBuilder>)	Adiciona um middleware Microsoft.AspNetCore.Routing.EndpointMiddleware ao IApplicationBuilder especificado com as instâncias de EndpointDataSource criadas a partir do IEndpointRouteBuilderconfigurado. O Microsoft.AspNetCore.Routing.EndpointMiddleware executará o Endpoint associado à solicitação atual.
UseRouting(IApplicationBuilder)	Adiciona um middleware Microsoft.AspNetCore.Routing.EndpointRoutingMiddleware ao IApplicationBuilderespecificado.
UseExceptionHandler(IApplicationBuilder)	Adiciona um middleware ao pipeline que capturará exceções, registrará em log e executará novamente a solicitação em um pipeline alternativo. A solicitação não será executada novamente se a resposta já tiver sido iniciada.
UseExceptionHandler(IApplicationBuilder, ExceptionHandlerOptions)	Adiciona um middleware ao pipeline que capturará exceções, registrará em log e executará novamente a solicitação em um pipeline alternativo. A solicitação não será executada novamente se a resposta já tiver sido iniciada.
UseExceptionHandler(IApplicationBuilder, Action<IApplicationBuilder>)	Adiciona um middleware ao pipeline que capturará exceções, registrará em log e executará novamente a solicitação em um pipeline alternativo. A solicitação não será executada novamente se a resposta já tiver sido iniciada.
UseExceptionHandler(IApplicationBuilder, String)	Adiciona um middleware ao pipeline que capturará exceções, registrará em log, redefinirá o caminho da solicitação e executará novamente a solicitação. A solicitação não será executada novamente se a resposta já tiver sido iniciada.
UseExceptionHandler(IApplicationBuilder, String, Boolean)	Adiciona um middleware ao pipeline que capturará exceções, registrará em log, redefinirá o caminho da solicitação e executará novamente a solicitação. A solicitação não será executada novamente se a resposta já tiver sido iniciada.
UseFileServer(IApplicationBuilder)	Habilite todo o middleware de arquivo estático (exceto a navegação de diretório) para o caminho de solicitação atual no diretório atual.
UseFileServer(IApplicationBuilder, FileServerOptions)	Habilitar todo o middleware de arquivo estático com as opções fornecidas
UseFileServer(IApplicationBuilder, Boolean)	Habilite todo o middleware de arquivo estático para o caminho de solicitação atual no diretório atual.
UseFileServer(IApplicationBuilder, String)	Habilita todo o middleware de arquivo estático (exceto a navegação de diretório) para o caminho de solicitação fornecido do diretório com o mesmo nome
UseForwardedHeaders(IApplicationBuilder)	Aplica cabeçalhos encaminhados aos campos correspondentes na solicitação atual. Por convenção, proxies HTTP encaminham informações do cliente em cabeçalhos HTTP conhecidos. O ForwardedHeadersMiddleware lê esses cabeçalhos e preenche os campos associados em HttpContext.
UseForwardedHeaders(IApplicationBuilder, ForwardedHeadersOptions)	Aplica cabeçalhos encaminhados aos campos correspondentes na solicitação atual. Por convenção, proxies HTTP encaminham informações do cliente em cabeçalhos HTTP conhecidos. O ForwardedHeadersMiddleware lê esses cabeçalhos e preenche os campos associados em HttpContext.
UseHeaderPropagation(IApplicationBuilder)	Adiciona um middleware que coleta cabeçalhos a serem propagados para um HttpClient.
UseHealthChecks(IApplicationBuilder, PathString)	Adiciona um middleware que fornece o status de verificação de integridade.
UseHealthChecks(IApplicationBuilder, PathString, HealthCheckOptions)	Adiciona um middleware que fornece o status de verificação de integridade.
UseHealthChecks(IApplicationBuilder, PathString, Int32)	Adiciona um middleware que fornece o status de verificação de integridade.
UseHealthChecks(IApplicationBuilder, PathString, Int32, HealthCheckOptions)	Adiciona um middleware que fornece o status de verificação de integridade.
UseHealthChecks(IApplicationBuilder, PathString, String)	Adiciona um middleware que fornece o status de verificação de integridade.
UseHealthChecks(IApplicationBuilder, PathString, String, HealthCheckOptions)	Adiciona um middleware que fornece o status de verificação de integridade.
UseHostFiltering(IApplicationBuilder)	Adiciona middleware para filtrar solicitações por cabeçalhos de host permitidos. Solicitações inválidas serão rejeitadas com um código de status 400.
UseHsts(IApplicationBuilder)	Adiciona middleware para usar o HSTS, que adiciona o cabeçalho strict-Transport-Security.
UseHttpLogging(IApplicationBuilder)	Adiciona um middleware que pode registrar em log solicitações e respostas HTTP.
UseW3CLogging(IApplicationBuilder)	Adiciona um middleware que pode registrar em log solicitações HTTP e respostas para logs de servidor no formato W3C.
UseHttpMethodOverride(IApplicationBuilder)	Permite que a solicitação POST de entrada substitua o tipo de método com o tipo especificado no cabeçalho. Esse middleware é usado quando um cliente está limitado a enviar métodos GET ou POST, mas deseja invocar outros métodos HTTP. Por padrão, o cabeçalho de solicitação X-HTTP-Method-Override é usado para especificar o método HTTP que está sendo túnel.
UseHttpMethodOverride(IApplicationBuilder, HttpMethodOverrideOptions)	Permite que a solicitação POST de entrada substitua o tipo de método com o tipo especificado no formulário. Esse middleware é usado quando um cliente está limitado a enviar métodos GET ou POST, mas deseja invocar outros métodos HTTP.
UseHttpsRedirection(IApplicationBuilder)	Adiciona middleware para redirecionar solicitações HTTP para HTTPS.
Map(IApplicationBuilder, PathString, Action<IApplicationBuilder>)	Ramifica o pipeline de solicitação com base nas correspondências do caminho de solicitação fornecido. Se o caminho da solicitação começar com o caminho fornecido, o branch será executado.
Map(IApplicationBuilder, PathString, Boolean, Action<IApplicationBuilder>)	Ramifica o pipeline de solicitação com base nas correspondências do caminho de solicitação fornecido. Se o caminho da solicitação começar com o caminho fornecido, o branch será executado.
Map(IApplicationBuilder, String, Action<IApplicationBuilder>)	Ramifica o pipeline de solicitação com base nas correspondências do caminho de solicitação fornecido. Se o caminho da solicitação começar com o caminho fornecido, o branch será executado.
MapWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Ramifica o pipeline de solicitação com base no resultado do predicado fornecido.
UseMigrationsEndPoint(IApplicationBuilder)	Processa solicitações para executar operações de migrações. O middleware escutará as solicitações feitas para DefaultPath.
UseMigrationsEndPoint(IApplicationBuilder, MigrationsEndPointOptions)	Processa solicitações para executar operações de migrações. O middleware escutará solicitações para o caminho configurado no options.
UseMvc(IApplicationBuilder)	Adiciona o MVC ao pipeline de execução de solicitação IApplicationBuilder.
UseMvc(IApplicationBuilder, Action<IRouteBuilder>)	Adiciona o MVC ao pipeline de execução de solicitação IApplicationBuilder.
UseMvcWithDefaultRoute(IApplicationBuilder)	Adiciona o MVC ao pipeline de execução de solicitação IApplicationBuilder com uma rota padrão chamada 'default' e o seguinte modelo: '{controller=Home}/{action=Index}/{id?}'.
UseOutputCache(IApplicationBuilder)	Adiciona o Microsoft.AspNetCore.OutputCaching.OutputCacheMiddleware para armazenar em cache respostas HTTP.
UseOwin(IApplicationBuilder)	Adiciona um pipeline OWIN ao IApplicationBuilderespecificado.
UseOwin(IApplicationBuilder, Action<Action<Func<Func<IDictionary<String,Object>,Task>,Func<IDictionary<String,Object>,Task>>>>)	Adiciona o pipeline de middleware OWIN ao IApplicationBuilderespecificado.
UseRateLimiter(IApplicationBuilder)	Habilita a limitação de taxa para o aplicativo.
UseRateLimiter(IApplicationBuilder, RateLimiterOptions)	Habilita a limitação de taxa para o aplicativo.
UseRequestDecompression(IApplicationBuilder)	Adiciona middleware para descompactar dinamicamente os corpos de solicitação HTTP.
UseRequestTimeouts(IApplicationBuilder)	Habilita tempos limite de solicitação para o aplicativo. Nenhum tempo limite é configurado por padrão. Eles devem ser configurados em RequestTimeoutOptions, no RequestTimeoutAttribute nos pontos de extremidade ou usando as extensões de roteamento WithRequestTimeout.
UseResponseCaching(IApplicationBuilder)	Adiciona o ResponseCachingMiddleware para armazenar em cache respostas HTTP.
UseResponseCompression(IApplicationBuilder)	Adiciona middleware para compactar dinamicamente respostas HTTP.
UseRewriter(IApplicationBuilder)	Verifica se uma determinada URL corresponde a regras e condições e modifica o HttpContext na correspondência.
UseRewriter(IApplicationBuilder, RewriteOptions)	Verifica se uma determinada URL corresponde a regras e condições e modifica o HttpContext na correspondência.
UseRouter(IApplicationBuilder, IRouter)	Adiciona um middleware RouterMiddleware ao IApplicationBuilder especificado com o IRouterespecificado.
UseRouter(IApplicationBuilder, Action<IRouteBuilder>)	Adiciona um middleware RouterMiddleware à IApplicationBuilder especificada com a IRouter criada a partir do IRouteBuilderconfigurado.
Run(IApplicationBuilder, RequestDelegate)	Adiciona um delegado de middleware de terminal ao pipeline de solicitação do aplicativo.
UseSession(IApplicationBuilder)	Adiciona o SessionMiddleware para habilitar automaticamente o estado da sessão para o aplicativo.
UseSession(IApplicationBuilder, SessionOptions)	Adiciona o SessionMiddleware para habilitar automaticamente o estado da sessão para o aplicativo.
UseSpa(IApplicationBuilder, Action<ISpaBuilder>)	Manipula todas as solicitações desse ponto na cadeia de middleware retornando a página padrão do SPA (Aplicativo de Página Única). Esse middleware deve ser colocado no final da cadeia, de modo que outro middleware para servir arquivos estáticos, ações de MVC etc., tenha precedência.
UseStaticFiles(IApplicationBuilder)	Habilita o serviço de arquivo estático para o caminho de solicitação atual
UseStaticFiles(IApplicationBuilder, StaticFileOptions)	Habilita o serviço de arquivo estático com as opções fornecidas
UseStaticFiles(IApplicationBuilder, String)	Habilita o serviço de arquivo estático para o caminho de solicitação fornecido
UseStatusCodePages(IApplicationBuilder)	Adiciona um middleware StatusCodePages com um manipulador de resposta padrão que verifica respostas com códigos de status entre 400 e 599 que não têm um corpo.
UseStatusCodePages(IApplicationBuilder, StatusCodePagesOptions)	Adiciona um middleware StatusCodePages com as opções fornecidas que verificam respostas com códigos de status entre 400 e 599 que não têm um corpo.
UseStatusCodePages(IApplicationBuilder, Action<IApplicationBuilder>)	Adiciona um middleware StatusCodePages ao pipeline com o pipeline de middleware alternativo especificado a ser executado para gerar o corpo da resposta.
UseStatusCodePages(IApplicationBuilder, Func<StatusCodeContext,Task>)	Adiciona um middleware StatusCodePages com o manipulador especificado que verifica respostas com códigos de status entre 400 e 599 que não têm um corpo.
UseStatusCodePages(IApplicationBuilder, String, String)	Adiciona um middleware StatusCodePages com o corpo de resposta especificado a ser enviado. Isso pode incluir um espaço reservado '{0}' para o código de status. O middleware verifica se há respostas com códigos de status entre 400 e 599 que não têm um corpo.
UseStatusCodePagesWithRedirects(IApplicationBuilder, String)	Adiciona um middleware StatusCodePages ao pipeline. Especifica que as respostas devem ser tratadas redirecionando com o modelo de URL de localização fornecido. Isso pode incluir um espaço reservado '{0}' para o código de status. As URLs que começam com '~' terão o PathBase pré-acrescentado, em que qualquer outra URL será usada como está.
UseStatusCodePagesWithReExecute(IApplicationBuilder, String, String)	Adiciona um middleware StatusCodePages ao pipeline. Especifica que o corpo da resposta deve ser gerado executando novamente o pipeline de solicitação usando um caminho alternativo. Esse caminho pode conter um espaço reservado '{0}' do código de status.
Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>)	Adiciona um delegado de middleware definido em linha ao pipeline de solicitação do aplicativo. Se você não estiver chamando a próxima função, use Run(IApplicationBuilder, RequestDelegate) em vez disso.
Use(IApplicationBuilder, Func<HttpContext,Func<Task>,Task>)	Adiciona um delegado de middleware definido em linha ao pipeline de solicitação do aplicativo. Se você não estiver chamando a próxima função, use Run(IApplicationBuilder, RequestDelegate) em vez disso. Prefira usar Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>) para melhorar o desempenho, conforme mostrado abaixo: app.Use((context, next) => { return next(context); });
UseMiddleware(IApplicationBuilder, Type, Object[])	Adiciona um tipo de middleware ao pipeline de solicitação do aplicativo.
UseMiddleware<TMiddleware>(IApplicationBuilder, Object[])	Adiciona um tipo de middleware ao pipeline de solicitação do aplicativo.
UsePathBase(IApplicationBuilder, PathString)	Adiciona um middleware que extrai a base de caminho especificada do caminho da solicitação e a postpendá-la à base do caminho da solicitação.
UseWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Cria condicionalmente um branch no pipeline de solicitação que é retornado ao pipeline principal.
UseWebAssemblyDebugging(IApplicationBuilder)	Adiciona o middleware necessário para depurar aplicativos Blazor WebAssembly dentro das ferramentas de desenvolvimento do Chromium.
UseWebSockets(IApplicationBuilder)	Adiciona o WebSocketMiddleware ao pipeline de solicitação.
UseWebSockets(IApplicationBuilder, WebSocketOptions)	Adiciona o WebSocketMiddleware ao pipeline de solicitação.
UseWelcomePage(IApplicationBuilder)	Adiciona o WelcomePageMiddleware ao pipeline.
UseWelcomePage(IApplicationBuilder, WelcomePageOptions)	Adiciona o WelcomePageMiddleware ao pipeline com as opções fornecidas.
UseWelcomePage(IApplicationBuilder, PathString)	Adiciona o WelcomePageMiddleware ao pipeline com o caminho fornecido.
UseWelcomePage(IApplicationBuilder, String)	Adiciona o WelcomePageMiddleware ao pipeline com o caminho fornecido.
UseHttpLoggingMiddleware(IApplicationBuilder)	Registra o middleware de registro de solicitação HTTP de entrada no IApplicationBuilder.
UseRequestCheckpoint(IApplicationBuilder)	Registra middlewares relacionados ao Ponto de Verificação de Solicitação no pipeline.
UseRequestLatencyTelemetry(IApplicationBuilder)	Adiciona o middleware de telemetria de latência de solicitação para IApplicationBuilder pipeline de execução de solicitação.
UseSpaStaticFiles(IApplicationBuilder)	Configura o aplicativo para fornecer arquivos estáticos para um SPA (Aplicativo de Página Única). Os arquivos serão localizados usando o serviço ISpaStaticFileProvider registrado.
UseSpaStaticFiles(IApplicationBuilder, StaticFileOptions)	Configura o aplicativo para fornecer arquivos estáticos para um SPA (Aplicativo de Página Única). Os arquivos serão localizados usando o serviço ISpaStaticFileProvider registrado.