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 para recursos do IFeatureCollection 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 que a 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 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.

UseConnections(IApplicationBuilder, Action<ConnectionsRouteBuilder>)
Obsoleto.

Adiciona suporte para manipuladores de conexão ASP.NET Core ao pipeline de execução da IApplicationBuilder solicitação.

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 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)

Implementação padrão para IApplicationBuilder.

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 em 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 respostas HTTP.

UseRewriter(IApplicationBuilder)

Verifica se uma determinada URL corresponde a regras e condições e modifica o HttpContext em correspondência.

UseRewriter(IApplicationBuilder, RewriteOptions)

Verifica se uma determinada URL corresponde a regras e condições e modifica o HttpContext em 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 compilado a IRouter partir do 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 da sessão para o aplicativo.

UseSession(IApplicationBuilder, SessionOptions)

Adiciona o para habilitar automaticamente o SessionMiddleware estado da sessão para o aplicativo.

UseSignalR(IApplicationBuilder, Action<HubRouteBuilder>)
Obsoleto.

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

Esse método é obsoleto e será removido em uma versão futura. A alternativa recomendada é usar o THub> do MapHub<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 fornecer arquivos estáticos, ações de MVC etc., tenha precedência.

UseStaticFiles(IApplicationBuilder)

Habilita o serviço de arquivo estático para o caminho da 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 respostas com status códigos 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 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 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.

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ê sempre possa atender a recursos webpack atualizados sem precisar executar o compilador manualmente. Como a instância do compilador Webpack é mantida 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 a saída do compilador Webpack diretamente, 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 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 .

Aplica-se a