Compartilhar via


ApplicationBuilder Classe

Definição

Implementação padrão para 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
Herança
ApplicationBuilder
Implementações

Construtores

ApplicationBuilder(IServiceProvider)

Inicializa uma nova instância de ApplicationBuilder.

ApplicationBuilder(IServiceProvider, Object)

Inicializa uma nova instância de ApplicationBuilder.

Propriedades

ApplicationServices

Obtém o IServiceProvider para serviços de aplicativo.

Properties

Obtém um conjunto de propriedades para ApplicationBuilder.

ServerFeatures

Obtém o IFeatureCollection para recursos de servidor.

Métodos

Build()

Produz um RequestDelegate que executa middlewares adicionados.

New()

Cria uma cópia desse construtor de aplicativos.

O clone criado tem as mesmas propriedades da instância atual, mas não copia o pipeline de solicitação.

Use(Func<RequestDelegate,RequestDelegate>)

Adiciona o middleware ao pipeline de solicitação de 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.

UseConnections(IApplicationBuilder, Action<ConnectionsRouteBuilder>)
Obsoleto.

Adiciona suporte para ASP.NET Manipuladores de Conexão Principais ao pipeline de execução de solicitação IApplicationBuilder.

Esse método é obsoleto e será removido em uma versão futura. A alternativa recomendada é usar MapConnections ou MapConnectionHandler<> TConnectionHandler dentro de Microsoft.AspNetCore.Builder.UseEndpoints(...).

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.

UseSignalR(IApplicationBuilder, Action<HubRouteBuilder>)
Obsoleto.

Adiciona o SignalR ao pipeline de execução de solicitação IApplicationBuilder.

Esse método é obsoleto e será removido em uma versão futura. A alternativa recomendada é usar o MapHub<> do THub dentro de Microsoft.AspNetCore.Builder.UseEndpoints(...).

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.

UseWebpackDevMiddleware(IApplicationBuilder, WebpackDevMiddlewareOptions)
Obsoleto.

Habilita o suporte ao middleware de desenvolvimento do Webpack. Isso hospeda uma instância do compilador Webpack na memória em seu aplicativo para que você possa sempre servir up-torecursos compilados pelo Webpack sem precisar executar o compilador manualmente. Como a instância do compilador do Webpack é retida na memória, a compilação incremental é muito mais rápida que executar novamente o compilador do zero.

As solicitações de entrada que correspondem aos arquivos compilados pelo Webpack serão tratadas retornando diretamente a saída do compilador webpack, independentemente dos arquivos no disco. Se a compilação estiver em andamento quando a solicitação chegar, a resposta será pausada até que a saída do compilador atualizada esteja pronta.

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.

Aplica-se a