IApplicationBuilder Interfaz

Definición

Espacio de nombres:

Microsoft.AspNetCore.Builder

Ensamblado:

Microsoft.AspNetCore.Http.Abstractions.dll

Paquete:

Microsoft.AspNetCore.App.Ref v8.0.0

Source:

IApplicationBuilder.cs

Define una clase que proporciona los mecanismos para configurar la canalización de solicitudes de una aplicación.

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

Propiedades

ApplicationServices	Obtiene o establece el IServiceProvider que proporciona acceso al contenedor de servicios de la aplicación.
Properties	Obtiene una colección de clave-valor que se puede usar para compartir datos entre middleware.
ServerFeatures	Obtiene el conjunto de características HTTP que proporciona el servidor de la aplicación.

Métodos

Build()	Compila el delegado usado por esta aplicación para procesar solicitudes HTTP.
New()	Crea un nuevo IApplicationBuilder que comparte el Properties de este IApplicationBuilder.
Use(Func<RequestDelegate,RequestDelegate>)	Agrega un delegado de middleware a la canalización de solicitudes de la aplicación.

Métodos de extensión

UseAntiforgery(IApplicationBuilder)	Agrega el middleware anti-forgery a la canalización.
UseRequestLocalization(IApplicationBuilder)	Agrega el RequestLocalizationMiddleware para establecer automáticamente la información de referencia cultural de las solicitudes en función de la información proporcionada por el cliente.
UseRequestLocalization(IApplicationBuilder, RequestLocalizationOptions)	Agrega el RequestLocalizationMiddleware para establecer automáticamente la información de referencia cultural de las solicitudes en función de la información proporcionada por el cliente.
UseRequestLocalization(IApplicationBuilder, Action<RequestLocalizationOptions>)	Agrega el RequestLocalizationMiddleware para establecer automáticamente la información de referencia cultural de las solicitudes en función de la información proporcionada por el cliente.
UseRequestLocalization(IApplicationBuilder, String[])	Agrega el RequestLocalizationMiddleware para establecer automáticamente la información de referencia cultural de las solicitudes en función de la información proporcionada por el cliente.
UseAuthentication(IApplicationBuilder)	Agrega el AuthenticationMiddleware al IApplicationBuilderespecificado, que habilita las funcionalidades de autenticación.
UseAuthorization(IApplicationBuilder)	Agrega el AuthorizationMiddleware al IApplicationBuilderespecificado, 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 del 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. Agrega el ConcurrencyLimiterMiddleware para limitar el número de solicitudes que se ejecutan simultáneamente.
UseCookiePolicy(IApplicationBuilder)	Agrega el controlador de CookiePolicyMiddleware al IApplicationBuilderespecificado, que habilita las funcionalidades de la directiva de cookies.
UseCookiePolicy(IApplicationBuilder, CookiePolicyOptions)	Agrega el controlador de CookiePolicyMiddleware al IApplicationBuilderespecificado, que habilita las funcionalidades de la directiva de cookies.
UseCors(IApplicationBuilder)	Agrega un middleware CORS a la canalización de la aplicación web para permitir solicitudes entre dominios.
UseCors(IApplicationBuilder, Action<CorsPolicyBuilder>)	Agrega un middleware CORS a la canalización de la aplicación web para permitir solicitudes entre dominios.
UseCors(IApplicationBuilder, String)	Agrega un 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 detalles de las posibles acciones 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 detalles de las posibles acciones 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 predeterminada con las opciones especificadas.
UseDefaultFiles(IApplicationBuilder, String)	Habilita la asignación de archivos predeterminada para la ruta de acceso de solicitud dada.
UseDeveloperExceptionPage(IApplicationBuilder)	Captura instancias de Exception sincrónicas y asincrónicas de la canalización y genera respuestas de error HTML.
UseDeveloperExceptionPage(IApplicationBuilder, DeveloperExceptionPageOptions)	Captura instancias de Exception sincrónicas y asincrónicas 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)	Habilitación de la exploración de directorios con las opciones especificadas
UseDirectoryBrowser(IApplicationBuilder, String)	Habilita la exploración de directorios para la ruta de acceso de solicitud dada.
UseEndpoints(IApplicationBuilder, Action<IEndpointRouteBuilder>)	Agrega un middleware de Microsoft.AspNetCore.Routing.EndpointMiddleware al IApplicationBuilder especificado con las instancias de EndpointDataSource creadas a partir de IEndpointRouteBuilderconfiguradas. El Microsoft.AspNetCore.Routing.EndpointMiddleware ejecutará el Endpoint asociado a la solicitud actual.
UseRouting(IApplicationBuilder)	Agrega un middleware de Microsoft.AspNetCore.Routing.EndpointRoutingMiddleware al IApplicationBuilderespecificado.
UseExceptionHandler(IApplicationBuilder)	Agrega un middleware a la canalización que detectará excepciones, las registrará 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, las registrará 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, las registrará 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)	Habilite todo el middleware de archivos estáticos (excepto la exploración de directorios) para la ruta de acceso de solicitud actual en el directorio actual.
UseFileServer(IApplicationBuilder, FileServerOptions)	Habilitación de todo el middleware de archivos estáticos con las opciones especificadas
UseFileServer(IApplicationBuilder, Boolean)	Habilite todo el middleware de archivos estáticos en para la ruta de acceso de solicitud actual en el directorio actual.
UseFileServer(IApplicationBuilder, String)	Habilita todo el middleware de archivos estáticos (excepto la exploración de directorios) para la ruta de acceso de solicitud especificada desde el directorio del 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. El 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. El 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 un 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 del 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 acceso de la solicitud comienza con la ruta de acceso especificada, se ejecuta 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 acceso de la solicitud comienza con la ruta de acceso especificada, se ejecuta 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 acceso de la solicitud comienza con la ruta de acceso especificada, se ejecuta la rama.
MapWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Bifurca la canalización de solicitudes en función del resultado del predicado especificado.
UseMigrationsEndPoint(IApplicationBuilder)	Procesa las solicitudes para ejecutar operaciones de migraciones. El middleware escuchará las solicitudes realizadas a DefaultPath.
UseMigrationsEndPoint(IApplicationBuilder, MigrationsEndPointOptions)	Procesa las solicitudes para ejecutar operaciones de migraciones. 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 de IApplicationBuilder.
UseMvc(IApplicationBuilder, Action<IRouteBuilder>)	Agrega MVC a la canalización de ejecución de solicitudes de IApplicationBuilder.
UseMvcWithDefaultRoute(IApplicationBuilder)	Agrega MVC a la canalización de ejecución de solicitudes de IApplicationBuilder con una ruta predeterminada denominada "default" y la siguiente plantilla: '{controller=Home}/{action=Index}/{id?}'.
UseOutputCache(IApplicationBuilder)	Agrega el Microsoft.AspNetCore.OutputCaching.OutputCacheMiddleware para almacenar en caché las respuestas HTTP.
UseOwin(IApplicationBuilder)	Agrega una canalización OWIN al IApplicationBuilderespecificado.
UseOwin(IApplicationBuilder, Action<Action<Func<Func<IDictionary<String,Object>,Task>,Func<IDictionary<String,Object>,Task>>>>)	Agrega la canalización de middleware de OWIN al IApplicationBuilderespecificado.
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, el RequestTimeoutAttribute en los puntos de conexión o mediante las extensiones de enrutamiento WithRequestTimeout.
UseResponseCaching(IApplicationBuilder)	Agrega el ResponseCachingMiddleware para almacenar en caché las 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 middleware RouterMiddleware al IApplicationBuilder especificado con el IRouterespecificado.
UseRouter(IApplicationBuilder, Action<IRouteBuilder>)	Agrega un middleware de RouterMiddleware al IApplicationBuilder especificado con el IRouter compilado a partir de IRouteBuilderconfigurados.
Run(IApplicationBuilder, RequestDelegate)	Agrega un delegado de middleware de terminal a la canalización de solicitudes de la aplicación.
UseSession(IApplicationBuilder)	Agrega el SessionMiddleware para habilitar automáticamente el estado de sesión de la aplicación.
UseSession(IApplicationBuilder, SessionOptions)	Agrega el SessionMiddleware para habilitar automáticamente el estado de sesión de la aplicación.
UseSpa(IApplicationBuilder, Action<ISpaBuilder>)	Controla todas las solicitudes desde este punto de 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 otros middleware para atender archivos estáticos, acciones de MVC, etcetera., tienen prioridad.
UseStaticFiles(IApplicationBuilder)	Habilita el servicio de archivos estáticos para la ruta de acceso de solicitud actual.
UseStaticFiles(IApplicationBuilder, StaticFileOptions)	Habilita el servicio de archivos estáticos con las opciones especificadas.
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 comprueban las 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 para 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 si hay 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 antepuesto PathBase, 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 al volver a ejecutar la canalización de solicitudes 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 función siguiente, 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 función siguiente, 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 postpendla 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 solicitud que se vuelve a unir a la canalización principal.
UseWebAssemblyDebugging(IApplicationBuilder)	Agrega middleware necesario para depurar aplicaciones WebAssembly de Blazor dentro de las herramientas de desarrollo de Chromium.
UseWebSockets(IApplicationBuilder)	Agrega el WebSocketMiddleware a la canalización de solicitudes.
UseWebSockets(IApplicationBuilder, WebSocketOptions)	Agrega el WebSocketMiddleware a 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 especificadas.
UseWelcomePage(IApplicationBuilder, PathString)	Agrega WelcomePageMiddleware a la canalización con la ruta de acceso especificada.
UseWelcomePage(IApplicationBuilder, String)	Agrega WelcomePageMiddleware a la canalización con la ruta de acceso especificada.
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 a IApplicationBuilder canalización de ejecución de solicitudes.
UseSpaStaticFiles(IApplicationBuilder)	Configura la aplicación para proporcionar archivos estáticos para una aplicación de página única (SPA). Los archivos se ubicarán mediante el servicio ISpaStaticFileProvider registrado.
UseSpaStaticFiles(IApplicationBuilder, StaticFileOptions)	Configura la aplicación para proporcionar archivos estáticos para una aplicación de página única (SPA). Los archivos se ubicarán mediante el servicio ISpaStaticFileProvider registrado.