IApplicationBuilder Interface

Definição

Namespace:

Microsoft.AspNetCore.Builder

Assembly:

Microsoft.AspNetCore.Http.Abstractions.dll

Pacote:

Microsoft.AspNetCore.App.Ref v8.0.0

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 antifalsificação ao pipeline.
UseRequestLocalization(IApplicationBuilder)	Adiciona o RequestLocalizationMiddleware para definir automaticamente as informações de cultura para solicitações com base nas informações fornecidas pelo cliente.
UseRequestLocalization(IApplicationBuilder, RequestLocalizationOptions)	Adiciona o RequestLocalizationMiddleware para definir automaticamente as 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 as informações de cultura para solicitações com base nas informações fornecidas pelo cliente.
UseRequestLocalization(IApplicationBuilder, String[])	Adiciona o RequestLocalizationMiddleware para definir automaticamente as informações de cultura para solicitações com base nas informações fornecidas pelo cliente.
UseAuthentication(IApplicationBuilder)	Adiciona o AuthenticationMiddleware ao especificado IApplicationBuilder, que habilita os recursos de autenticação.
UseAuthorization(IApplicationBuilder)	Adiciona o AuthorizationMiddleware ao especificado IApplicationBuilder, que habilita os 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 para decodificá-lo e atualiza HttpContext.Connection.ClientCertificate.
UseBlazorFrameworkFiles(IApplicationBuilder)	Configura o aplicativo para fornecer 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 WebAssembly do Blazor referenciado.
UseConcurrencyLimiter(IApplicationBuilder)	Obsoleto. Adiciona o ConcurrencyLimiterMiddleware para limitar o número de solicitações em execução simultâneas.
UseCookiePolicy(IApplicationBuilder)	Adiciona o CookiePolicyMiddleware manipulador ao especificado IApplicationBuilder, que habilita os recursos de política de cookie.
UseCookiePolicy(IApplicationBuilder, CookiePolicyOptions)	Adiciona o CookiePolicyMiddleware manipulador ao especificado IApplicationBuilder, que habilita os recursos de política de cookie.
UseCors(IApplicationBuilder)	Adiciona um middleware CORS ao seu pipeline de aplicativos Web para permitir solicitações cruzadas de domínio.
UseCors(IApplicationBuilder, Action<CorsPolicyBuilder>)	Adiciona um middleware CORS ao seu pipeline de aplicativos Web para permitir solicitações cruzadas de domínio.
UseCors(IApplicationBuilder, String)	Adiciona um middleware CORS ao seu pipeline de aplicativos Web para permitir solicitações cruzadas de domínio.
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 estas exceções ocorrem, é gerada uma resposta HTML com detalhes das ações possíveis para resolver o problema.
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 estas exceções ocorrem, é gerada uma resposta HTML com detalhes das ações possíveis para resolver o problema.
UseDefaultFiles(IApplicationBuilder)	Habilita o mapeamento de arquivo padrão no caminho atual
UseDefaultFiles(IApplicationBuilder, DefaultFilesOptions)	Habilita o mapeamento de arquivos padrão com as opções especificadas
UseDefaultFiles(IApplicationBuilder, String)	Habilita o mapeamento de arquivo padrão para o caminho de solicitação fornecido
UseDeveloperExceptionPage(IApplicationBuilder)	Captura instâncias síncronas e assíncronas Exception do pipeline e gera respostas de erro HTML.
UseDeveloperExceptionPage(IApplicationBuilder, DeveloperExceptionPageOptions)	Captura instâncias síncronas e assíncronas Exception 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 pesquisa no diretório com as opções especificadas
UseDirectoryBrowser(IApplicationBuilder, String)	Habilita a navegação de diretório para o caminho de solicitação fornecido
UseEndpoints(IApplicationBuilder, Action<IEndpointRouteBuilder>)	Adiciona um Microsoft.AspNetCore.Routing.EndpointMiddleware middleware ao especificado IApplicationBuilder com as EndpointDataSource instâncias criadas do configurado IEndpointRouteBuilder. O Microsoft.AspNetCore.Routing.EndpointMiddleware executará o Endpoint associado à solicitação atual.
UseRouting(IApplicationBuilder)	Adiciona um Microsoft.AspNetCore.Routing.EndpointRoutingMiddleware middleware ao especificado IApplicationBuilder.
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)	Habilitar todos os middleware de arquivos estáticos (exceto a pesquisa no diretório) para o caminho da solicitação atual no diretório atual.
UseFileServer(IApplicationBuilder, FileServerOptions)	Habilitar todos os middleware de arquivos estáticos com as opções especificadas
UseFileServer(IApplicationBuilder, Boolean)	Habilitar todos os middleware de arquivos estáticos para o caminho da solicitação atual no diretório atual.
UseFileServer(IApplicationBuilder, String)	Habilita todos os middleware de arquivos estáticos (exceto a pesquisa no diretório) para o caminho da solicitação especificado do diretório com o mesmo nome
UseForwardedHeaders(IApplicationBuilder)	Aplica cabeçalhos encaminhados aos campos correspondentes na solicitação atual. Por convenção, os 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, os 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 marcar status de integridade.
UseHealthChecks(IApplicationBuilder, PathString, HealthCheckOptions)	Adiciona um middleware que fornece marcar status de integridade.
UseHealthChecks(IApplicationBuilder, PathString, Int32)	Adiciona um middleware que fornece marcar status de integridade.
UseHealthChecks(IApplicationBuilder, PathString, Int32, HealthCheckOptions)	Adiciona um middleware que fornece marcar status de integridade.
UseHealthChecks(IApplicationBuilder, PathString, String)	Adiciona um middleware que fornece marcar status de integridade.
UseHealthChecks(IApplicationBuilder, PathString, String, HealthCheckOptions)	Adiciona um middleware que fornece marcar status 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 solicitações e respostas HTTP.
UseW3CLogging(IApplicationBuilder)	Adiciona um middleware que pode registrar 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 pelo 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 encapsulado.
UseHttpMethodOverride(IApplicationBuilder, HttpMethodOverrideOptions)	Permite que a solicitação POST de entrada substitua o tipo de método pelo 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 iniciar com o caminho especificado, 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 iniciar com o caminho especificado, 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 iniciar com o caminho especificado, o branch será executado.
MapWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Ramifica o pipeline de solicitação com base no resultado do predicado em questão.
UseMigrationsEndPoint(IApplicationBuilder)	Processa solicitações para executar operações de migrações. O middleware escutará as solicitações feitas ao DefaultPath.
UseMigrationsEndPoint(IApplicationBuilder, MigrationsEndPointOptions)	Processa solicitações para executar operações de migrações. O middleware escutará solicitações para o caminho configurado em options.
UseMvc(IApplicationBuilder)	Adiciona o MVC ao pipeline de execução da IApplicationBuilder solicitação.
UseMvc(IApplicationBuilder, Action<IRouteBuilder>)	Adiciona o MVC ao pipeline de execução da IApplicationBuilder solicitação.
UseMvcWithDefaultRoute(IApplicationBuilder)	Adiciona o MVC ao pipeline de execução de IApplicationBuilder solicitação com uma rota padrão chamada 'default' e o seguinte modelo: '{controller=Home}/{action=Index}/{id?}'.
UseOutputCache(IApplicationBuilder)	Define uma classe que fornece os mecanismos para configurar o pipeline de solicitação de um aplicativo.
UseOwin(IApplicationBuilder)	Adiciona um pipeline OWIN ao especificado IApplicationBuilder.
UseOwin(IApplicationBuilder, Action<Action<Func<Func<IDictionary<String,Object>,Task>,Func<IDictionary<String,Object>,Task>>>>)	Adiciona o pipeline de middleware OWIN ao especificado IApplicationBuilder.
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 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 no RequestTimeoutOptions, nos RequestTimeoutAttribute 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 as respostas HTTP.
UseRewriter(IApplicationBuilder)	Verifica se uma determinada URL corresponde às regras e condições e modifica o HttpContext na correspondência.
UseRewriter(IApplicationBuilder, RewriteOptions)	Verifica se uma determinada URL corresponde às regras e condições e modifica o HttpContext na correspondência.
UseRouter(IApplicationBuilder, IRouter)	Adiciona um RouterMiddleware middleware ao especificado IApplicationBuilder com o especificado IRouter.
UseRouter(IApplicationBuilder, Action<IRouteBuilder>)	Adiciona um RouterMiddleware middleware ao especificado IApplicationBuilder com o IRouter compilado de configurado IRouteBuilder.
Run(IApplicationBuilder, RequestDelegate)	Adiciona um delegado de middleware de terminal ao pipeline de solicitação do aplicativo.
UseSession(IApplicationBuilder)	Adiciona o para habilitar automaticamente o SessionMiddleware estado de sessão para o aplicativo.
UseSession(IApplicationBuilder, SessionOptions)	Adiciona o para habilitar automaticamente o SessionMiddleware estado de 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, para que outros middlewares para fornecer arquivos estáticos, ações de MVC etc., tenham precedência.
UseStaticFiles(IApplicationBuilder)	Habilita o serviço de arquivo estático para o caminho de solicitação atual
UseStaticFiles(IApplicationBuilder, StaticFileOptions)	Habilita servir arquivos estáticos com as opções especificadas
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 se há 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 se há respostas com status códigos 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 se há respostas com status códigos entre 400 e 599 que não têm um corpo.
UseStatusCodePages(IApplicationBuilder, String, String)	Adiciona um middleware StatusCodePages com o corpo da resposta especificado a ser enviado. Isso pode incluir um espaço reservado '{0}' para o código status. O middleware verifica se há respostas com status códigos 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 status. As URLs que começam com '~' terão PathBase prefixado, 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 por meio de um caminho alternativo. Esse caminho pode conter um espaço reservado '{0}' do código 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 de solicitação e a aplica posteriormente à base do caminho de solicitação.
UseWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Cria condicionalmente um branch no pipeline de solicitação que é reencontrado para o pipeline de main.
UseWebAssemblyDebugging(IApplicationBuilder)	Adiciona o middleware necessário para depurar aplicativos Blazor WebAssembly dentro Chromium ferramentas de desenvolvimento.
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 especificadas.
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 log 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 solicitar o pipeline de execuçã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 registrado ISpaStaticFileProvider .
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 registrado ISpaStaticFileProvider .