ApplicationBuilder Clase

Definición

Implementación predeterminada 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
Herencia
ApplicationBuilder
Implementaciones

Constructores

ApplicationBuilder(IServiceProvider)

Inicializa una nueva instancia de la clase ApplicationBuilder.

ApplicationBuilder(IServiceProvider, Object)

Inicializa una nueva instancia de la clase ApplicationBuilder.

Propiedades

ApplicationServices

Obtiene para los IServiceProvider servicios de aplicación.

Properties

Obtiene un conjunto de propiedades para ApplicationBuilder.

ServerFeatures

Obtiene para las características del IFeatureCollection servidor.

Métodos

Build()

Genera un RequestDelegate objeto que ejecuta middleware agregados.

New()

Crea una copia de este generador de aplicaciones.

El clon creado tiene las mismas propiedades que la instancia actual, pero no copia la canalización de solicitudes.

Use(Func<RequestDelegate,RequestDelegate>)

Agrega el middleware a la canalización de solicitud de aplicación.

Métodos de extensión

UseAntiforgery(IApplicationBuilder)

Agrega el middleware anti-forgery a la canalización.

UseRequestLocalization(IApplicationBuilder)

Agrega para establecer automáticamente la RequestLocalizationMiddleware información de referencia cultural de las solicitudes en función de la información proporcionada por el cliente.

UseRequestLocalization(IApplicationBuilder, RequestLocalizationOptions)

Agrega para establecer automáticamente la RequestLocalizationMiddleware información de referencia cultural de las solicitudes en función de la información proporcionada por el cliente.

UseRequestLocalization(IApplicationBuilder, Action<RequestLocalizationOptions>)

Agrega para establecer automáticamente la RequestLocalizationMiddleware información de referencia cultural de las solicitudes en función de la información proporcionada por el cliente.

UseRequestLocalization(IApplicationBuilder, String[])

Agrega para establecer automáticamente la RequestLocalizationMiddleware información de referencia cultural de las solicitudes en función de la información proporcionada por el cliente.

UseAuthentication(IApplicationBuilder)

Agrega al AuthenticationMiddleware objeto especificado IApplicationBuilder, que habilita las funcionalidades de autenticación.

UseAuthorization(IApplicationBuilder)

Agrega al AuthorizationMiddleware objeto especificado IApplicationBuilder, que habilita las funcionalidades de autorización.

Al autorizar un recurso que se enruta mediante el enrutamiento de puntos de conexión, esta llamada debe aparecer entre las llamadas a app.UseRouting() y app.UseEndpoints(...) para que el middleware funcione correctamente.

UseCertificateForwarding(IApplicationBuilder)

Agrega un middleware a la canalización que buscará un certificado en un encabezado de solicitud descodificarlo y actualiza HttpContext.Connection.ClientCertificate.

UseBlazorFrameworkFiles(IApplicationBuilder)

Configura la aplicación para proporcionar archivos de marco WebAssembly de Blazor desde la ruta de acceso raíz "/".

UseBlazorFrameworkFiles(IApplicationBuilder, PathString)

Configura la aplicación para proporcionar archivos de marco WebAssembly de Blazor desde la ruta de acceso pathPrefix. Esta ruta de acceso debe corresponder a un proyecto de aplicación WebAssembly de Blazor al que se hace referencia.

UseConcurrencyLimiter(IApplicationBuilder)
Obsoletos.

ConcurrencyLimiterMiddleware Agrega para limitar el número de solicitudes que se ejecutan simultáneamente.

UseConnections(IApplicationBuilder, Action<ConnectionsRouteBuilder>)
Obsoletos.

Agrega compatibilidad con ASP.NET Core controladores de conexión a la canalización de ejecución de solicitudesIApplicationBuilder.

Este método está obsoleto y se quitará en una versión futura. La alternativa recomendada es usar MapConnections o MapConnectionHandler TConnectionHandler<> dentro de Microsoft.AspNetCore.Builder.UseEndpoints(...).

UseCookiePolicy(IApplicationBuilder)

Agrega el CookiePolicyMiddleware controlador al especificado IApplicationBuilder, que habilita las funcionalidades de la directiva de cookies.

UseCookiePolicy(IApplicationBuilder, CookiePolicyOptions)

Agrega el CookiePolicyMiddleware controlador al especificado IApplicationBuilder, que habilita las funcionalidades de la directiva de cookies.

UseCors(IApplicationBuilder)

Agrega middleware CORS a la canalización de la aplicación web para permitir solicitudes entre dominios.

UseCors(IApplicationBuilder, Action<CorsPolicyBuilder>)

Agrega middleware CORS a la canalización de la aplicación web para permitir solicitudes entre dominios.

UseCors(IApplicationBuilder, String)

Agrega middleware CORS a la canalización de la aplicación web para permitir solicitudes entre dominios.

UseDatabaseErrorPage(IApplicationBuilder)
Obsoletos.

Captura excepciones sincrónicas y asincrónicas relacionadas con la base de datos de la canalización que se pueden resolver mediante migraciones de Entity Framework. Cuando se producen estas excepciones, se genera una respuesta HTML con los detalles de las acciones posibles para resolver el problema.

UseDatabaseErrorPage(IApplicationBuilder, DatabaseErrorPageOptions)
Obsoletos.

Captura excepciones sincrónicas y asincrónicas relacionadas con la base de datos de la canalización que se pueden resolver mediante migraciones de Entity Framework. Cuando se producen estas excepciones, se genera una respuesta HTML con los detalles de las acciones posibles para resolver el problema.

UseDefaultFiles(IApplicationBuilder)

Habilita la asignación de archivos predeterminada en la ruta de acceso actual.

UseDefaultFiles(IApplicationBuilder, DefaultFilesOptions)

Habilita la asignación de archivos predeterminados con las opciones dadas

UseDefaultFiles(IApplicationBuilder, String)

Habilita la asignación de archivos predeterminada para la ruta de acceso de solicitud especificada.

UseDeveloperExceptionPage(IApplicationBuilder)

Captura instancias sincrónicas y asincrónicas Exception de la canalización y genera respuestas de error HTML.

UseDeveloperExceptionPage(IApplicationBuilder, DeveloperExceptionPageOptions)

Captura instancias sincrónicas y asincrónicas Exception de la canalización y genera respuestas de error HTML.

UseDirectoryBrowser(IApplicationBuilder)

Habilitación de la exploración de directorios en la ruta de acceso actual

UseDirectoryBrowser(IApplicationBuilder, DirectoryBrowserOptions)

Habilita el examen de directorios con las opciones dadas

UseDirectoryBrowser(IApplicationBuilder, String)

Habilita la exploración de directorios para la ruta de acceso de solicitud especificada.

UseEndpoints(IApplicationBuilder, Action<IEndpointRouteBuilder>)

Agrega un Microsoft.AspNetCore.Routing.EndpointMiddleware middleware al especificado IApplicationBuilder con las EndpointDataSource instancias compiladas a partir de configuradas IEndpointRouteBuilder. Microsoft.AspNetCore.Routing.EndpointMiddleware ejecutará el Endpoint asociado a la solicitud actual.

UseRouting(IApplicationBuilder)

Agrega un Microsoft.AspNetCore.Routing.EndpointRoutingMiddleware middleware al especificado IApplicationBuilder.

UseExceptionHandler(IApplicationBuilder)

Agrega un middleware a la canalización que detectará excepciones, registrarlas y volver a ejecutar la solicitud en una canalización alternativa. La solicitud no se volverá a ejecutar si la respuesta ya se ha iniciado.

UseExceptionHandler(IApplicationBuilder, ExceptionHandlerOptions)

Agrega un middleware a la canalización que detectará excepciones, registrarlas y volver a ejecutar la solicitud en una canalización alternativa. La solicitud no se volverá a ejecutar si la respuesta ya se ha iniciado.

UseExceptionHandler(IApplicationBuilder, Action<IApplicationBuilder>)

Agrega un middleware a la canalización que detectará excepciones, registrarlas y volver a ejecutar la solicitud en una canalización alternativa. La solicitud no se volverá a ejecutar si la respuesta ya se ha iniciado.

UseExceptionHandler(IApplicationBuilder, String)

Agrega un middleware a la canalización que detectará excepciones, registrarlas, restablecer la ruta de acceso de la solicitud y volver a ejecutar la solicitud. La solicitud no se volverá a ejecutar si la respuesta ya se ha iniciado.

UseExceptionHandler(IApplicationBuilder, String, Boolean)

Agrega un middleware a la canalización que detectará excepciones, registrarlas, restablecer la ruta de acceso de la solicitud y volver a ejecutar la solicitud. La solicitud no se volverá a ejecutar si la respuesta ya se ha iniciado.

UseFileServer(IApplicationBuilder)

Habilita el middleware de archivos estáticos (excepto el examen de directorios) de la ruta de acceso de solicitud actual del directorio actual.

UseFileServer(IApplicationBuilder, FileServerOptions)

Habilita el middleware de archivos estáticos con las opciones dadas

UseFileServer(IApplicationBuilder, Boolean)

Habilita el middleware de archivos estáticos para la ruta de acceso de solicitud actual del directorio actual.

UseFileServer(IApplicationBuilder, String)

Habilita el middleware de archivos estáticos (excepto el examen de directorios) para la ruta de acceso de solicitud dada desde el directorio con el mismo nombre

UseForwardedHeaders(IApplicationBuilder)

Aplica encabezados reenviados a sus campos coincidentes en la solicitud actual.

Por convención, los servidores proxy HTTP reenvía información del cliente en encabezados HTTP conocidos. ForwardedHeadersMiddleware lee estos encabezados y rellena los campos asociados en HttpContext.

UseForwardedHeaders(IApplicationBuilder, ForwardedHeadersOptions)

Aplica encabezados reenviados a sus campos coincidentes en la solicitud actual.

Por convención, los servidores proxy HTTP reenvía información del cliente en encabezados HTTP conocidos. ForwardedHeadersMiddleware lee estos encabezados y rellena los campos asociados en HttpContext.

UseHeaderPropagation(IApplicationBuilder)

Agrega un middleware que recopila encabezados que se van a propagar a .HttpClient

UseHealthChecks(IApplicationBuilder, PathString)

Agrega un middleware que proporciona el estado de comprobación de estado.

UseHealthChecks(IApplicationBuilder, PathString, HealthCheckOptions)

Agrega un middleware que proporciona el estado de comprobación de estado.

UseHealthChecks(IApplicationBuilder, PathString, Int32)

Agrega un middleware que proporciona el estado de comprobación de estado.

UseHealthChecks(IApplicationBuilder, PathString, Int32, HealthCheckOptions)

Agrega un middleware que proporciona el estado de comprobación de estado.

UseHealthChecks(IApplicationBuilder, PathString, String)

Agrega un middleware que proporciona el estado de comprobación de estado.

UseHealthChecks(IApplicationBuilder, PathString, String, HealthCheckOptions)

Agrega un middleware que proporciona el estado de comprobación de estado.

UseHostFiltering(IApplicationBuilder)

Agrega middleware para filtrar solicitudes por encabezados de host permitidos. Las solicitudes no válidas se rechazarán con un código de estado 400.

UseHsts(IApplicationBuilder)

Agrega middleware para usar HSTS, que agrega el encabezado Strict-Transport-Security.

UseHttpLogging(IApplicationBuilder)

Agrega un middleware que puede registrar solicitudes y respuestas HTTP.

UseW3CLogging(IApplicationBuilder)

Agrega un middleware que puede registrar solicitudes HTTP y respuestas para los registros de servidor en formato W3C.

UseHttpMethodOverride(IApplicationBuilder)

Permite que la solicitud POST entrante invalide el tipo de método con el tipo especificado en el encabezado. Este middleware se usa cuando un cliente está limitado a enviar métodos GET o POST, pero quiere invocar otros métodos HTTP. De forma predeterminada, el encabezado de solicitud X-HTTP-Method-Override se usa para especificar el método HTTP que se está tunelizando.

UseHttpMethodOverride(IApplicationBuilder, HttpMethodOverrideOptions)

Permite que la solicitud POST entrante invalide el tipo de método con el tipo especificado en el formulario. Este middleware se usa cuando un cliente está limitado a enviar métodos GET o POST, pero quiere invocar otros métodos HTTP.

UseHttpsRedirection(IApplicationBuilder)

Agrega middleware para redirigir solicitudes HTTP a HTTPS.

Map(IApplicationBuilder, PathString, Action<IApplicationBuilder>)

Bifurca la canalización de solicitudes en función de las coincidencias de la ruta de acceso de solicitud especificada. Si la ruta de solicitud comienza con la ruta proporcionada, se ejecuta la creación de la rama.

Map(IApplicationBuilder, PathString, Boolean, Action<IApplicationBuilder>)

Bifurca la canalización de solicitudes en función de las coincidencias de la ruta de acceso de solicitud especificada. Si la ruta de solicitud comienza con la ruta proporcionada, se ejecuta la creación de la rama.

Map(IApplicationBuilder, String, Action<IApplicationBuilder>)

Bifurca la canalización de solicitudes en función de las coincidencias de la ruta de acceso de solicitud especificada. Si la ruta de solicitud comienza con la ruta proporcionada, se ejecuta la creación de la rama.

MapWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)

Bifurca la canalización de solicitud a partir del resultado del predicado proporcionado.

UseMigrationsEndPoint(IApplicationBuilder)

Procesa las solicitudes para ejecutar operaciones de migración. El middleware escuchará las solicitudes realizadas a DefaultPath.

UseMigrationsEndPoint(IApplicationBuilder, MigrationsEndPointOptions)

Procesa las solicitudes para ejecutar operaciones de migración. El middleware escuchará las solicitudes a la ruta de acceso configurada en options.

UseMvc(IApplicationBuilder)

Agrega MVC a la canalización de ejecución de solicitudes IApplicationBuilder .

UseMvc(IApplicationBuilder, Action<IRouteBuilder>)

Agrega MVC a la canalización de ejecución de solicitudes IApplicationBuilder .

UseMvcWithDefaultRoute(IApplicationBuilder)

Agrega MVC a la canalización de ejecución de solicitudes IApplicationBuilder con una ruta predeterminada denominada "default" y la plantilla siguiente: '{controller=Home}/{action=Index}/{id?}'.

UseOutputCache(IApplicationBuilder)

Implementación predeterminada para IApplicationBuilder.

UseOwin(IApplicationBuilder)

Agrega una canalización OWIN al especificado IApplicationBuilder.

UseOwin(IApplicationBuilder, Action<Action<Func<Func<IDictionary<String,Object>,Task>,Func<IDictionary<String,Object>,Task>>>>)

Agrega la canalización de middleware de OWIN al especificado IApplicationBuilder.

UseRateLimiter(IApplicationBuilder)

Habilita la limitación de velocidad para la aplicación.

UseRateLimiter(IApplicationBuilder, RateLimiterOptions)

Habilita la limitación de velocidad para la aplicación.

UseRequestDecompression(IApplicationBuilder)

Agrega middleware para descomprimir dinámicamente los cuerpos de solicitud HTTP.

UseRequestTimeouts(IApplicationBuilder)

Habilita los tiempos de espera de solicitud para la aplicación.

No hay tiempos de espera configurados de forma predeterminada. Deben configurarse en RequestTimeoutOptions, en los RequestTimeoutAttribute puntos de conexión o mediante las extensiones de enrutamiento WithRequestTimeout.

UseResponseCaching(IApplicationBuilder)

Agrega para ResponseCachingMiddleware almacenar en caché respuestas HTTP.

UseResponseCompression(IApplicationBuilder)

Agrega middleware para comprimir dinámicamente las respuestas HTTP.

UseRewriter(IApplicationBuilder)

Comprueba si una dirección URL determinada coincide con las reglas y condiciones, y modifica HttpContext en coincidencia.

UseRewriter(IApplicationBuilder, RewriteOptions)

Comprueba si una dirección URL determinada coincide con las reglas y condiciones, y modifica HttpContext en coincidencia.

UseRouter(IApplicationBuilder, IRouter)

Agrega un RouterMiddleware middleware al especificado IApplicationBuilder con el especificado IRouter.

UseRouter(IApplicationBuilder, Action<IRouteBuilder>)

Agrega un RouterMiddleware middleware al especificado IApplicationBuilder con el IRouter creado a partir de configurado IRouteBuilder.

Run(IApplicationBuilder, RequestDelegate)

Agrega un delegado de middleware de terminal a la canalización de solicitudes de la aplicación.

UseSession(IApplicationBuilder)

Agrega para habilitar automáticamente el SessionMiddleware estado de sesión para la aplicación.

UseSession(IApplicationBuilder, SessionOptions)

Agrega para habilitar automáticamente el SessionMiddleware estado de sesión para la aplicación.

UseSignalR(IApplicationBuilder, Action<HubRouteBuilder>)
Obsoletos.

Agrega SignalR a la canalización de ejecución de solicitudes IApplicationBuilder .

Este método está obsoleto y se quitará en una versión futura. La alternativa recomendada es usar MapHub THub<> dentro de Microsoft.AspNetCore.Builder.UseEndpoints(...).

UseSpa(IApplicationBuilder, Action<ISpaBuilder>)

Controla todas las solicitudes de este punto en la cadena de middleware devolviendo la página predeterminada de la aplicación de página única (SPA).

Este middleware debe colocarse tarde en la cadena, de modo que otro middleware para atender archivos estáticos, acciones de MVC, etc., tenga prioridad.

UseStaticFiles(IApplicationBuilder)

Habilita el servicio de archivos estáticos para la ruta de acceso de solicitud actual.

UseStaticFiles(IApplicationBuilder, StaticFileOptions)

Habilita el envío de archivos estáticos con las opciones dadas

UseStaticFiles(IApplicationBuilder, String)

Habilita el servicio de archivos estáticos para la ruta de acceso de solicitud especificada.

UseStatusCodePages(IApplicationBuilder)

Agrega un middleware StatusCodePages con un controlador de respuesta predeterminado que comprueba si hay respuestas con códigos de estado entre 400 y 599 que no tienen un cuerpo.

UseStatusCodePages(IApplicationBuilder, StatusCodePagesOptions)

Agrega un middleware StatusCodePages con las opciones especificadas que comprueba si hay respuestas con códigos de estado entre 400 y 599 que no tienen un cuerpo.

UseStatusCodePages(IApplicationBuilder, Action<IApplicationBuilder>)

Agrega un middleware StatusCodePages a la canalización con la canalización de middleware alternativa especificada que se va a ejecutar para generar el cuerpo de la respuesta.

UseStatusCodePages(IApplicationBuilder, Func<StatusCodeContext,Task>)

Agrega un middleware StatusCodePages con el controlador especificado que comprueba si hay respuestas con códigos de estado entre 400 y 599 que no tienen un cuerpo.

UseStatusCodePages(IApplicationBuilder, String, String)

Agrega un middleware StatusCodePages con el cuerpo de respuesta especificado que se va a enviar. Esto puede incluir un marcador de posición "{0}" para el código de estado. El middleware comprueba las respuestas con códigos de estado entre 400 y 599 que no tienen un cuerpo.

UseStatusCodePagesWithRedirects(IApplicationBuilder, String)

Agrega un middleware StatusCodePages a la canalización. Especifica que las respuestas se deben controlar redirigiendo con la plantilla de dirección URL de ubicación especificada. Esto puede incluir un marcador de posición "{0}" para el código de estado. Las direcciones URL que comienzan por "~" tendrán pathBase antepuesto, donde cualquier otra dirección URL se usará tal cual.

UseStatusCodePagesWithReExecute(IApplicationBuilder, String, String)

Agrega un middleware StatusCodePages a la canalización. Especifica que el cuerpo de la respuesta se debe generar volviendo a ejecutar la canalización de la solicitud mediante una ruta de acceso alternativa. Esta ruta de acceso puede contener un marcador de posición "{0}" del código de estado.

Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>)

Agrega un delegado de middleware definido en línea a la canalización de solicitud de la aplicación. Si no llama a la siguiente función, use Run(IApplicationBuilder, RequestDelegate) en su lugar.

Use(IApplicationBuilder, Func<HttpContext,Func<Task>,Task>)

Agrega un delegado de middleware definido en línea a la canalización de solicitud de la aplicación. Si no llama a la siguiente función, use Run(IApplicationBuilder, RequestDelegate) en su lugar.

Prefiere usar Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>) para mejorar el rendimiento, como se muestra a continuación:

app.Use((context, next) =>
{
    return next(context);
});
UseMiddleware(IApplicationBuilder, Type, Object[])

Agrega un tipo de middleware a la canalización de solicitudes de la aplicación.

UseMiddleware<TMiddleware>(IApplicationBuilder, Object[])

Agrega un tipo de middleware a la canalización de solicitudes de la aplicación.

UsePathBase(IApplicationBuilder, PathString)

Agrega un middleware que extrae la base de ruta de acceso especificada de la ruta de acceso de solicitud y la pospendá a la base de ruta de acceso de solicitud.

UseWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)

Crea condicionalmente una rama en la canalización de solicitudes que se vuelve a unir a la canalización principal.

UseWebAssemblyDebugging(IApplicationBuilder)

Agrega middleware necesario para depurar aplicaciones WebAssembly de Blazor dentro de Chromium herramientas de desarrollo.

UseWebpackDevMiddleware(IApplicationBuilder, WebpackDevMiddlewareOptions)
Obsoletos.

Habilita la compatibilidad con middleware de desarrollo de Webpack. Esto hospeda una instancia del compilador de Webpack en la memoria de la aplicación para que siempre pueda servir recursos actualizados compilados por Webpack sin tener que ejecutar el compilador manualmente. Puesto que la instancia del compilador de Webpack se conserva en memoria, la compilación incremental es mucho más rápida que volver a ejecutar el compilador desde cero.

Las solicitudes entrantes que coincidan con los archivos compilados por Webpack se controlarán devolviendo la salida del compilador de Webpack directamente, independientemente de los archivos del disco. Si la compilación está en curso cuando llega la solicitud, la respuesta se pausará hasta que la salida del compilador actualizada esté lista.

UseWebSockets(IApplicationBuilder)

Agrega a WebSocketMiddleware la canalización de solicitudes.

UseWebSockets(IApplicationBuilder, WebSocketOptions)

Agrega a WebSocketMiddleware la canalización de solicitudes.

UseWelcomePage(IApplicationBuilder)

Agrega WelcomePageMiddleware a la canalización.

UseWelcomePage(IApplicationBuilder, WelcomePageOptions)

Agrega WelcomePageMiddleware a la canalización con las opciones proporcionadas.

UseWelcomePage(IApplicationBuilder, PathString)

Agrega WelcomePageMiddleware a la canalización con la ruta de acceso proporcionada.

UseWelcomePage(IApplicationBuilder, String)

Agrega WelcomePageMiddleware a la canalización con la ruta de acceso proporcionada.

UseHttpLoggingMiddleware(IApplicationBuilder)

Registra el middleware de registro de solicitudes HTTP entrantes en IApplicationBuilder.

UseRequestCheckpoint(IApplicationBuilder)

Registra los middleware relacionados con el punto de control de solicitud en la canalización.

UseRequestLatencyTelemetry(IApplicationBuilder)

Agrega el middleware de telemetría de latencia de solicitud para IApplicationBuilder solicitar la canalización de ejecución.

UseSpaStaticFiles(IApplicationBuilder)

Configura la aplicación para que sirva archivos estáticos para una aplicación de página única (SPA). Los archivos se ubicarán mediante el servicio registrado ISpaStaticFileProvider .

UseSpaStaticFiles(IApplicationBuilder, StaticFileOptions)

Configura la aplicación para que sirva archivos estáticos para una aplicación de página única (SPA). Los archivos se ubicarán mediante el servicio registrado ISpaStaticFileProvider .

Se aplica a