首页 / ASP.NET / Asp.Net Core 中间件

Asp.Net Core 中间件

内容导读

互联网集市收集整理的这篇技术教程文章主要介绍了Asp.Net Core 中间件，小编现在分享给大家，供广大互联网技能从业者学习和参考。文章包含7609字，纯文字阅读大概需要11分钟。

内容图文

什么是中间件（Middleware）？

中间件是组装到应用程序管道中以处理请求和响应的软件。每个组件：

选择是否将请求传递给管道中的下一个组件。
可以在调用管道中的下一个组件之前和之后执行工作。

请求委托（Request delegates）用于构建请求管道，处理每个HTTP请求。

请求委托使用Run，Map和Use扩展方法进行配置。单独的请求委托可以以内联匿名方法（称为内联中间件）指定，或者可以在可重用的类中定义它。这些可重用的类和内联匿名方法是中间件或中间件组件。请求流程中的每个中间件组件都负责调用流水线中的下一个组件，如果适当，则负责链接短路。

将HTTP模块迁移到中间件解释了ASP.NET Core和以前版本（ASP.NET）中的请求管道之间的区别，并提供了更多的中间件示例。

使用 IApplicationBuilder 创建中间件管道

ASP.NET Core请求流程由一系列请求委托组成，如下图所示（执行流程遵循黑色箭头）：

技术分享图片

每个委托可以在下一个委托之前和之后执行操作。委托还可以决定不将请求传递给下一个委托，这称为请求管道的短路。短路通常是可取的，因为它避免了不必要的工作。例如，静态文件中间件可以返回一个静态文件的请求，并使管道的其余部分短路。需要在管道早期调用异常处理委托，因此它们可以捕获后面管道的异常。

最简单的可能是ASP.NET Core应用程序建立一个请求的委托，处理所有的请求。此案例不包含实际的请求管道。相反，针对每个HTTP请求都调用一个匿名方法。

            using
             Microsoft.AspNetCore.Builder;

            using
             Microsoft.AspNetCore.Hosting;

            using
             Microsoft.AspNetCore.Http;


            public
            class
             Startup
{
    
            public
            void
             Configure(IApplicationBuilder app)
    {
        app.Run(
            async context =>
        {
            await context.Response.WriteAsync("Hello, World!");
        });
    }
}

第一个 app.Run 委托终止管道。

如下代码:

技术分享图片

通过浏览器访问，发现确实在第一个app.Run终止了管道。

技术分享图片

可以将多个请求委托与app.Use连接在一起。 next参数表示管道中的下一个委托。（请记住，您可以通过不调用下一个参数来结束流水线。）通常可以在下一个委托之前和之后执行操作，如下例所示：

            public
            class
             Startup
{
    
            public
            void
             Configure(IApplicationBuilder app)
    {
        app.Use(
            async (context, next) =>
            {
                await context.Response.WriteAsync("进入第一个委托 执行下一个委托之前\r\n");
                //调用管道中的下一个委托await next.Invoke();
                await context.Response.WriteAsync("结束第一个委托 执行下一个委托之后\r\n");
            });
            app.Run(async context =>
            {
                await context.Response.WriteAsync("进入第二个委托\r\n");
                await context.Response.WriteAsync("Hello from 2nd delegate.\r\n");
                await context.Response.WriteAsync("结束第二个委托\r\n");
            });
    }
}

使用浏览器访问有如下结果：

技术分享图片

可以看出请求委托的执行顺序是遵循上面的流程图的。

注意：
响应发送到客户端后，请勿调用next.Invoke。响应开始之后，对HttpResponse的更改将抛出异常。例如，设置响应头，状态代码等更改将会引发异常。在调用next之后写入响应体。

可能导致协议违规。例如，写入超过content-length所述内容长度。
可能会破坏响应内容格式。例如，将HTML页脚写入CSS文件。

HttpResponse.HasStarted是一个有用的提示，指示是否已发送响应头和/或正文已写入。

顺序

在Startup。Configure方法中添加中间件组件的顺序定义了在请求上调用它们的顺序，以及响应的相反顺序。此排序对于安全性，性能和功能至关重要。

Startup.Configure方法（如下所示）添加了以下中间件组件：

异常/错误处理
静态文件服务
身份认证
MVC

            public
            void
             Configure(IApplicationBuilder app)
{
    app.UseExceptionHandler(
            "
            /Home/Error
            "); // Call first to catch exceptions
                                                                            // thrown in the following middleware.
    app.UseStaticFiles();                   // Return static files and end pipeline.
    app.UseAuthentication();               // Authenticate before you access
                                                            // secure resources.
    app.UseMvcWithDefaultRoute();          // Add MVC to the request pipeline.
}

上面的代码，UseExceptionHandler是添加到管道中的第一个中间件组件，因此它捕获以后调用中发生的任何异常。

静态文件中间件在管道中提前调用，因此可以处理请求和短路，而无需通过剩余的组件。静态文件中间件不提供授权检查。由其提供的任何文件，包括wwwroot下的文件都是公开的。

如果请求没有被静态文件中间件处理，它将被传递给执行身份验证的Identity中间件（app.UseAuthentication）。身份不会使未经身份验证的请求发生短路。虽然身份认证请求，但授权（和拒绝）仅在MVC选择特定的Razor页面或控制器和操作之后才会发生。

授权（和拒绝）仅在MVC选择特定的Razor页面或Controller和Action之后才会发生。

以下示例演示了中间件顺序，其中静态文件的请求在响应压缩中间件之前由静态文件中间件处理。静态文件不会按照中间件的顺序进行压缩。来自UseMvcWithDefaultRoute的MVC响应可以被压缩。

            public
            void
             Configure(IApplicationBuilder app)
{
    app.UseStaticFiles();         
            //
             Static files not compressed
                app.UseResponseCompression();
    app.UseMvcWithDefaultRoute();
}

Use, Run, 和 Map

可以使用Use，Run和Map配置HTTP管道。Use方法可以使管道短路（即，可以不调用下一个请求委托）。Run方法是一个约定，并且一些中间件组件可能暴露在管道末端运行的Run [Middleware]方法。Map*扩展用作分支管道的约定。映射根据给定的请求路径的匹配来分支请求流水线，如果请求路径以给定路径开始，则执行分支。

            public
            class
             Startup
{
    
            private
            static
            void
             HandleMapTest1(IApplicationBuilder app)
    {
        app.Run(
            async context =>
        {
            await context.Response.WriteAsync("Map Test 1");
        });
    }

    privatestaticvoid HandleMapTest2(IApplicationBuilder app)
    {
        app.Run(async context =>
        {
            await context.Response.WriteAsync("Map Test 2");
        });
    }

    publicvoid Configure(IApplicationBuilder app)
    {
        app.Map("/map1", HandleMapTest1);

        app.Map("/map2", HandleMapTest2);

        app.Run(async context =>
        {
            await context.Response.WriteAsync("Hello from non-Map delegate. <p>");
        });
    }
}

技术分享图片

下表显示了使用以前代码的 http://localhost:19219 的请求和响应：

请求	响应
localhost:1234	Hello from non-Map delegate.
localhost:1234/map1	Map Test 1
localhost:1234/map2	Map Test 2
localhost:1234/map3	Hello from non-Map delegate.

当使用Map时，匹配的路径段将从HttpRequest.Path中删除，并为每个请求追加到Http Request.PathBase。

MapWhen根据给定谓词的结果分支请求流水线。任何类型为Func<HttpContext,bool>的谓词都可用于将请求映射到管道的新分支。在以下示例中，谓词用于检测查询字符串变量分支的存在：

            public
            class
             Startup
{
    
            private
            static
            void
             HandleBranch(IApplicationBuilder app)
    {
        app.Run(
            async context =>
        {
            var branchVer = context.Request.Query["branch"];
            await context.Response.WriteAsync($"Branch used = {branchVer}");
        });
    }

    publicvoid Configure(IApplicationBuilder app)
    {
        app.MapWhen(context => context.Request.Query.ContainsKey("branch"),
                               HandleBranch);

        app.Run(async context =>
        {
            await context.Response.WriteAsync("Hello from non-Map delegate. <p>");
        });
    }

技术分享图片

以下下表显示了使用上面代码 http://localhost:19219 的请求和响应：

请求	响应
localhost:1234	Hello from non-Map delegate.
localhost:1234/?branch=1	Branch used = master

Map支持嵌套，例如：

app.Map("/level1", level1App => {
       level1App.Map("/level2a", level2AApp => {
           // "/level1/level2a"
           //...       });
       level1App.Map("/level2b", level2BApp => {
           // "/level1/level2b"
           //...       });
   });

Map也可以一次匹配多个片段，例如：

app.Map("/level1/level2", HandleMultiSeg);

内置中间件

ASP.NET Core附带以下中间件组件：

中间件	描述
Authentication	提供身份验证支持
CORS	配置跨域资源共享
Response Caching	提供缓存响应支持
Response Compression	提供响应压缩支持
Routing	定义和约束请求路由
Session	提供用户会话管理
Static Files	为静态文件和目录浏览提供服务提供支持
URL Rewriting Middleware	用于重写 Url，并将请求重定向的支持

编写中间件

中间件通常封装在一个类中，并使用扩展方法进行暴露。查看以下中间件，它从查询字符串设置当前请求的Culture：

            public
            class
             Startup
{
    
            public
            void
             Configure(IApplicationBuilder app)
    {
        app.Use((context, next) =>
        {
            var cultureQuery = context.Request.Query["culture"];
            if (!string.IsNullOrWhiteSpace(cultureQuery))
            {
                var culture = new CultureInfo(cultureQuery);

                CultureInfo.CurrentCulture = culture;
                CultureInfo.CurrentUICulture = culture;
            }

            // Call the next delegate/middleware in the pipelinereturn next();
        });

        app.Run(async (context) =>
        {
            await context.Response.WriteAsync(
                $"Hello {CultureInfo.CurrentCulture.DisplayName}");
        });

    }
}

您可以通过传递Culture来测试中间件，例如 http://localhost:19219/?culture=zh-CN

以下代码将中间件委托移动到一个类：

            using
             Microsoft.AspNetCore.Http;

            using
             System.Globalization;

            using
             System.Threading.Tasks;


            namespace
             Culture
{
    
            public
            class
             RequestCultureMiddleware
    {
        
            private
            readonly
             RequestDelegate _next;

        
            public
             RequestCultureMiddleware(RequestDelegate next)
        {
            _next = next;
        }

        public Task Invoke(HttpContext context)
        {
            var cultureQuery = context.Request.Query["culture"];
            if (!string.IsNullOrWhiteSpace(cultureQuery))
            {
                var culture = new CultureInfo(cultureQuery);

                CultureInfo.CurrentCulture = culture;
                CultureInfo.CurrentUICulture = culture;

            }

            // Call the next delegate/middleware in the pipelinereturnthis._next(context);
        }
    }
}

以下通过IApplicationBuilder的扩展方法暴露中间件

            using
             Microsoft.AspNetCore.Builder;


            namespace
             Culture
{
    
            public
            static
            class
             RequestCultureMiddlewareExtensions
    {
        
            public
            static
             IApplicationBuilder UseRequestCulture(
            
            this
             IApplicationBuilder builder)
        {
            
            return builder.UseMiddleware<RequestCultureMiddleware>();
        }
    }
}

以下代码从Configure调用中间件：

            public
            class
             Startup
{
    
            public
            void
             Configure(IApplicationBuilder app)
    {
        app.UseRequestCulture();

        app.Run(
            async (context) =>
        {
            await context.Response.WriteAsync(
                $"Hello {CultureInfo.CurrentCulture.DisplayName}");
        });

    }
}

中间件应该遵循显式依赖原则，通过在其构造函数中暴露其依赖关系。中间件在应用程序生命周期构建一次。如果您需要在请求中与中间件共享服务，请参阅以下请求相关性。

中间件组件可以通过构造方法参数来解析依赖注入的依赖关系。 UseMiddleware也可以直接接受其他参数。

每个请求的依赖关系

因为中间件是在应用程序启动时构建的，而不是每个请求，所以在每个请求期间，中间件构造函数使用的作用域生命周期服务不会与其他依赖注入类型共享。如果您必须在中间件和其他类型之间共享作用域服务，请将这些服务添加到Invoke方法的签名中。 Invoke方法可以接受由依赖注入填充的其他参数。例如：

            public
            class
             MyMiddleware
{
    
            private
            readonly
             RequestDelegate _next;

    
            public
             MyMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    publicasync Task Invoke(HttpContext httpContext, IMyScopedService svc)
    {
        svc.MyProperty = 1000;
        await _next(httpContext);
    }
}

原文：https://www.cnblogs.com/liuxiaoji/p/11490268.html

内容总结

以上是互联网集市为您收集整理的Asp.Net Core 中间件全部内容，希望文章能够帮你解决Asp.Net Core 中间件所遇到的程序开发问题。如果觉得互联网集市技术教程内容还不错，欢迎将互联网集市网站推荐给程序员好友。

内容备注

版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请发送邮件至 gblab@vip.qq.com 举报，一经查实，本站将立刻删除。

内容手机端

扫描二维码推送至手机访问。

本文链接：https://qyyshop.com/info/1283581.html

来源：【匿名】

【下一篇】asp.net伪静态关于页面优化和伪静态

更多 ►

【Asp.Net Core 中间件】教程文章相关的互联网学习教程文章

Asp.Net Core 中间件【代码】【图】

什么是中间件（Middleware）？中间件是组装到应用程序管道中以处理请求和响应的软件。每个组件：选择是否将请求传递给管道中的下一个组件。可以在调用管道中的下一个组件之前和之后执行工作。请求委托（Request delegates）用于构建请求管道，处理每个HTTP请求。请求委托使用Run，Map和Use扩展方法进行配置。单独的请求委托可以以内联匿名方法（称为内联中间件）指定，或者可以在可重用的类中定义它。这些可重用的类和内联匿名方法...

ASP.NET Core中间件(Middleware)实现WCF SOAP服务端解析【代码】【图】

ASP.NET Core中间件(Middleware)进阶学习实现SOAP 解析。本篇将介绍实现ASP.NET Core SOAP服务端解析，而不是ASP.NET Core整个WCF host。因为WCF中不仅仅只是有SOAP，它还包含很多如消息安全性，生成WSDL，双工信道，非HTTP传输等。ASP.NET Core 官方推荐大家使用RESTful Web API的解决方案提供网络服务。SOAP 即 Simple Object AccessProtocol 也就是简单对象访问协议。SOAP 呢，其指导理念是“唯一一个没有发明任何新技术的技术...

《ASP.NET Core 高性能系列》静态文件中间件【代码】【图】

原文:《ASP.NET Core 高性能系列》静态文件中间件一、概述　　静态文件（如 HTML、CSS、图片和 JavaScript等文件）是 Web程序直接提供给客户端的直接加载的文件。较比于程序动态交互的代码而言,其实原理都一样(走Http协议),ASP.NET Core中需要进行一些配置才能提供这些文件。二、wwwroot　　静态文件存储在项目的 Web 程序的 {ContentRoot}/wwwroot目录下，但可通过 UseWebRoot 方法更改路径。 Web 应用程序项目的 wwwroot 文件夹...

ASP.NET Core中使用GraphQL - 第二章中间件【代码】【图】

前文：ASP.NET Core中使用GraphQL - 第一章 Hello World中间件如果你熟悉ASP.NET Core的中间件，你可能会注意到之前的博客中我们已经使用了一个中间件，app.Run(async (context) => {var result = await new DocumentExecuter().ExecuteAsync(doc =>{doc.Schema = schema;doc.Query = @"query {hello}";}).ConfigureAwait(false);var json = new DocumentWriter(indent: true).Write(result)await context.Response.WriteAsync(jso...

ASP.NET Core-静态文件中间件【转】【代码】【图】

1. 静态文件　　MVC中默认开启静态文件中间件(在Configure方法中 app.UseStaticFiles())，即wwwroot目录(即根目录)下的文件均可以访问，eg： http://localhost:5000/img/001.png，其他目录下的静态文件不能访问（eg：MyStaticFiles），如果注释掉app.UseStaticFiles，wwwroot目录下的文件也不能直接访问了。2. wwwroot目录外的静态文件的访问　　在项目目录下新建一个文件夹（MyStaticFiles），里面存放图片等静态文件，这个时候是...

ASP.NET 5探险（8）：利用中间件、TagHelper来在MVC 6中实现Captcha

（此文章同时发表在本人微信公众号“dotNET每日精华文章”，欢迎右边二维码来关注。)题记：由于ASP.NET 5及MVC 6是一个微软全新重新的Web开发平台，之前一些现有的验证码库已经不能直接使用，故而我自行实现了一套简单的验证码库——CaptchaMVC6。CaptchaMVC6我已经开源到GitHub上（同时提供了使用范例给大家参考），大家可以通过“阅读原文”来访问项目页面。CaptchaMVC6虽然一些核心的一些算法和现有的验证码库没有本质区别，不过...

深入探究ASP.NET Core异常处理中间件【代码】【图】

前言????全局异常处理是我们编程过程中不可或缺的重要环节。有了全局异常处理机制给我们带来了很多便捷，首先我们不用满屏幕处理程序可能出现的异常，其次我们可以对异常进行统一的处理，比如收集异常信息或者返回统一的格式等等。ASP.NET Core为我们提供了两种机制去处理全局异常，一是基于中间件的方式，二是基于Filter过滤器的方式。Filter过滤器的方式相对来说比较简单，就是捕获Action执行过程中出现的异常，然后调用注册的Fi...

ASP.NET Core中间件和 ASP.NET HttpHandler HttpModule有什么区别？【图】

我们将原有ASP.NET应用升级到ASP.NET Core的过程中，会遇到一个新的概念：中间件。中间件是ASP.NET Core全新引入的概念。中间件是一种装配到应用管道中以处理请求和响应的软件。每个组件：选择是否将请求传递到管道中的下一个组件。可在管道中的下一个组件前后执行工作。单独看以上中间件的定义，一个很直观的感觉：中间件是HTTP请求管道中的一层层的AOP扩展。在展开介绍中间件之前，我们先回顾一下ASP.NET中HttpHandler和H...

ASP.NET Core 中的响应缓存中间件【代码】【图】

客户端(浏览器)缓存通过设置HTTP的响应头来完成 1、直接用Response对象去设置 [HttpGet]public IEnumerable<WeatherForecast> Get(){Console.WriteLine("服务响应");//直接一，简单粗暴，不要拼写错了就好~~Response.Headers[Microsoft.Net.Http.Headers.HeaderNames.CacheControl] = "public, max-age=600";var rng = new Random();return Enumerable.Range(1, 5).Select(index => new WeatherForecast{Date = DateTime.Now.AddD...

详解ASP.NET Core 中间件之压缩、缓存【图】

前言今天给大家介绍一下在 ASP.NET Core 日常开发中用的比较多的两个中间件，它们都是出自于微软的 ASP.NET 团队，他们分别是Microsoft.AspNetCore.ResponseCompression 和 Microsoft.AspNetCore.ResponseCaching ，下面让我们一起看看的功能以及如何去使用吧。 Getting Started Microsoft.AspNetCore.ResponseCompression Microsoft.AspNetCore.ResponseCompression 这个中间件是 .NET Core 1.1 版本中新增加的，看名字应该知道...

ASP.NET Core 使用app.UseStaticFiles配置静态文件中间件，达到类似IIS中虚拟目录的效果，可访问位于 Web 根目录之外的文件

1、项目中静态文件存放在wwwroot文件夹之下，如下：要访问nihao.jpg这个文件夹，url路径可以这样写：<img src="~/images/inhao.jpg" alt="pic"/> wwwroot css images nihao.jpgjs那么我要访问D盘的MyStaticFiles文件夹下的images文件夹下的banner1.svg问件该如何呢？这时我们可以在Startup.cs文件中配置app.UseStaticFiles来实现 D:/MyStaticFiles images banner1.svg配置如下：public void Configure(IApplicationBuilder app) {...

ASP.NET Core中间件实现分布式 Session(转载)【图】

ASP.NET Core中间件实现分布式 Session 1. ASP.NET Core中间件详解1.1. 中间件原理1.1.1. 什么是中间件 1.1.2. 中间件执行过程 1.1.3. 中间件的配置1.2. 依赖注入中间件 1.3. Cookies和session中间件1.3.1. Session 1.3.2. Session保存到Redis中 1.3.3. 实现分布Session1.4. 总结1.1. 中间件原理1.1.1. 什么是中间件中间件是段代码用于处理请求和响应，通常多个中间件链接起来形成管道，由每个中间件自己来决定是否要调用下一个中...

如何给asp.net core写个中间件记录接口耗时【图】

Intro写接口的难免会遇到别人说接口比较慢，到底慢多少，一个接口服务器处理究竟花了多长时间，如果能有具体的数字来记录每个接口耗时多少，别人再说接口慢的时候看一下接口耗时统计，如果几毫秒就处理完了，对不起这锅我不背。中间件实现asp.net core 的运行是一个又一个的中间件来完成的，因此我们只需要定义自己的中间件，记录请求开始处理前的时间和处理结束后的时间，这里的中间件把请求的耗时输出到日志里了，你也可以根据需...

ASP.NET Core中间件计算Http请求时间示例详解

ASP.NET Core通过RequestDelegate这个委托类型来定义中间件 public delegate Task RequestDelegate(HttpContext context);可将一个单独的请求委托并行指定为匿名方法（称为并行中间件），或在类中对其进行定义。可通过Use，或在Middleware类中配置要传递给委托执行的方法(参数类型HttpContext，返回值类型Task)。 public static IApplicationBuilder Use(this IApplicationBuilder app, Func<HttpContext, Func<Task>, Task> middl...

ASP.NET Core应用错误处理之DeveloperExceptionPageMiddleware中间件呈现“开发者异常页面”【图】

前言在《ASP.NET Core应用的错误处理[1]：三种呈现错误页面的方式》中，我们通过几个简单的实例演示了如何呈现一个错误页面，这些错误页面的呈现分别由三个对应的中间件来完成，接下来我们将对这三个中间件进行详细介绍。在开发环境呈现的异常页面是通过一个类型为DeveloperExceptionPageMiddleware中间件实现的。public class DeveloperExceptionPageMiddleware{public DeveloperExceptionPageMiddleware(RequestDelegate next, ...

ASP.NET - 技术教程分类

ASP.NET 教程 ASP.NET 简介 Razor 语法 MVC 应用程序 MVC 布局 MVC 控制器 MVC 数据库 MVC 模型 MVC 参考手册 WebForms 控件 asp.net 全部

ASP.NET - 最热教程

ASP.NET Core MVC 中实现中英文切换 ASP.NET Core WebAPI实现本地化（单资源...C#精髓 GridView72大绝技学习gridview...c# static的全部用法收集整理 ASP.NET之MVC框架及搭建教程(推荐)_实用...彻底解决Asp.netCore WebApi 3.1 跨域时...教你Asp.net下使用mysql数据库的步骤 ASP.NET Core 搭配 Nginx 的真实IP问题 asp.net core API 如何接收参数 C#-ASP.NET MVC：在列表框中填充(绑定数...

首页 / ASP.NET / Asp.Net Core 中间件

Asp.Net Core 中间件

内容导读

内容图文

什么是中间件（Middleware）？

使用 IApplicationBuilder 创建中间件管道

顺序

Use, Run, 和 Map

内置中间件

编写中间件

每个请求的依赖关系

内容总结

内容备注

内容手机端

【Asp.Net Core 中间件】教程文章相关的互联网学习教程文章

ASP.NET - 技术教程分类

ASP.NET - 最新教程

ASP.NET - 最热教程