app开发网站建设培训班,房屋设计图用什么软件,好的平面网站模板,域名查询入口静态文件 目录浏览 默认页面 MIME类型配置 实战文件服务器 紧接上一讲 中间件 之后#xff0c;今天来我们来讲一下关于 ASP.NET Core 中静态文件服务。什么是静态文件#xff1f;先看一下下面例子#xff08;在客户端浏览器中通过 url 路径访问了网站的一张图片#xff09… 静态文件 目录浏览 默认页面 MIME类型配置 实战文件服务器 紧接上一讲 中间件 之后今天来我们来讲一下关于 ASP.NET Core 中静态文件服务。什么是静态文件先看一下下面例子在客户端浏览器中通过 url 路径访问了网站的一张图片这样的图片就是一个静态文件静态文件staticfiles)其实就是指像 HTML、CSS、图片 和 JavaScript 之类固定的文件是会被应用程序直接提供给客户端的资源。静态文件通常位于web root内容根目录或Web根目录文件夹下。有关 内容根目录 和 Web根目录 的信息在第一讲中介绍过。 Web根目录默认为的是 Contentroot 路径下的 wwwroot 文件夹。 静态文件中间件将默认只读取 Web根目录和其子目录中的文件。 对于 Razor (.cshtml) 文件波浪号斜杠 ~/ 指向 webroot。 以 ~/ 开头的路径称为虚拟路径。内容根目录Contentroot是应用程序所用到的所有内容的根路径。WebHost.CreateDefaultBuilder() 中默认下把项目的当前目录设置为内容根目录也就是指 web 的项目的文件夹包括 bin 和 webroot 文件夹。Web根目录webroot项目中用于存放类似于 CSS、JS、图片等公开、静态资源的目录。静态文件可以保存在 Web根目录默认为wwwroot 下的任意文件夹内并通过相对根的路径来访问。例如当你通过 VisualStudio 创建一个默认的 Web应用程序MVC项目时在 wwwroot 目录下会多出几个文件夹css、images以及js。通过下面的URL就能够直接访问 images 目录下的图片http://app/images/imageFileNamehttp://localhost:7819/images/banner1.svg静态文件中间件如上例子为了能够使用静态文件的服务必须配置中间件把静态文件中间件加入到请求管道内。默认创建的 MVC Web应用程序已经配置了静态文件中间件可通过下述方法来配置在项目中增加 MicrosoftAspNetCore.StaticFiles 包依赖然后从Startup.Configure 中调用 app.UseStaticFiles 扩展方法public void Configure(IApplicationBuilder app, IHostingEnvironment env){ app.UseStaticFiles();} 上面我们通过一个简单的实例使用 app.UseStaticFiles() 来使用文件中间件使得Web根目录下的所有静态文件直接发布出来。如果我们需要发布的静态文件存储在其他目录下呢依旧是这个应用现在我们将静态文件放在自定义文件夹 MyStaticFiles 内并将以Web的形式发布出来展示如何通过使用 UseStaticFiles将其他非wwwroot目录下的内容也向外提供服务。mxfile userAgentMozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.89 Safari/537.36 version8.5.3 editorwww.draw.io typedevicediagram7Vtdk5owFP01PnaHEEB9rPbroZ3pdDvT5ygR00ZCQyxuf31vIBHZ6K6tQN1ddpydcMNHcs89h9wbHeH5Zvdekmz9ScSUj3wv3o3wm5HvY8D/9pwVxkCNK4MiWRxZfJqwy37TSsjstYti2neOFEJwRXLjBFVxqVIU7pUjROJlKJoXrsSPG5cl5GEOobbJeGu9RuL1bqyTvxxbf9AWbI2T0YomlY9C7L8kUixTc3zRj5elX9V94bYe5mR5WsSiLAhNO8FwKoarWZjenXLu26bZ3J3r345Y0Vedc4FcX/CJ8S2Iy3GpOsLGGKmm3BTxQj/Av4maaJ7Z0pk0OFBi9OVMk1p/KLbC6GU2JgDwlmSQrs6d/aLwv3A5aNubzZbMU4nwsuJFhSkeqn5BlZsjT5WD0i8mrTF/OoAEwC7rfipS/XLI5pqociFFFkUc5EX5YJlqoyNMIZfMA1c8mHIUwzTkco/oYPvp0qeYizZUkrHQnJbkqaK5HH0uRfSUyoXaqK5EqE8gIYJy5SBhw9Lzp7sBkkHlPxYYqeQenmN7QBIkl0WRSHRd1SCIbSOuDcPQjwwTDgmR/5zoSoGGC4Xhg4IsCo3SGOROdCpRGcBzB/ax4aQZH0FZsPAa/nrOZ2PAyeA3uXGUZDAxoBcYB4GHUDePA44JxVfFRS/NjrIvon8DYAAz8g99cyQF4hB1HsIoqPoMfJgvLPImeKCX1/I0J/iWoHHEZe1CRxhBwSW98fQjq5HNFw0PYno0hwv1pezRoe2vaHp4A/qq0fTwowZNRAjzpUQkmgxK0pgTjE8BflRJMByV4MkoQeNPlMBWXgYpaEEKpieQvyopQMhBvCiKsvTkR1zPeSGhlaj9FA9CAeal7Wu14cYrVVZ4D9EHQF6Ct6h8KDUs1kzRWwBXP7OQJCtB3KYxjQ2ELXAO4Xv5WRg6pAuOcc5rAQE354bwUzCZl4aCrWzZNVDk9QfCGWnyUPhoofBxZF3bUeEDuQnup7tb8BtbvmOc5sXRyiYNp0HvdHpDOSiYFIf4p743vESnojUhuuqBgnjdZmjxfDvk4/G8c8s9YhQ8cuvxlhKdXxzy3WX2gqXPlz7IhuyntXfgtoeqBPx2s5u8LqgT7uRrRYfH859Ak8d9O/M/q4qdBnKTLtje9aEZNl2N3i7Yzl12FzcUZHstyGL3VdZZQfbCTbuhINv4Bk50AvqrqsheuB03iEGvYnCkRtmdGFy2bzeIQUMMJiegvyoxwG7e6EA5DIt5DLYXWB3lMvgYmp2eRpABv93Ao7/Vd5Of/XcAIKsl3daXeFbtyNoodMMMhFvaH0craYEGqWxkOLRgrfHzGt6kHLl/O5dDrrS6B3b1bBgG7uymZcs0sOvLac0B4IFetwqaut9RaYlFcFj/DqbsO/itEX77Bw/diagram/mxfile如果要访问 MyStaticFiles 文件夹下的 test.png 图片可以这样配置静态文件中间件public void Configure(IApplicationBuilder app, IHostingEnvironment env){ app.UseStaticFiles(); app.UseStaticFiles(new StaticFileOptions() { FileProvider new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), MyStaticFiles)), RequestPath new PathString(/StaticFiles), });}ASP.NET Core 一般情况下都是利用一个FileProvider 对象来读取文件的它在处理针对静态文件的请求是也不例外。上边代码在静态文件中间件中在调用静态文件中间件的方法 UseStaticFiles()该方法可接受一个配置项对象 StaticFileOptions其内部具有一个 FileProvider 和请求路径的映射关系。如果调用 UseStaticFiles方法没有指定任何的参数那么这个映射关系的请求路径就是应用的基地址PathBase而FileProvider自然就是指向WebRoot目录的PhysicalFileProvider。通过访问 http://app/StaticFiles/test.png这样就能访问到 test.png 图片文件了。静态文件授权 静态文件中间件默认不提供授权检查。任何通过该模块提供访问的文件包括位丁 wwwroot 下的文件都是公开的那么如何给文件提供授权呢将文件保存在 wwwroot 之外并将目录设置为可被静态文件中间件访问到同时通过一个 controller action 来访问通过授权后返回HleResulU将文件保存在wwwroot之外并将目录设置为可被静态文件中间件访问到同时通过一个itrolleraction来访问通过授权后返回 FileResult。目录浏览以上通过注册的 StaticFileMiddleware 只会处理针对某个具体静态文件的请求如果我们向某个目录的URL发送HTTP请求得到的将是一个状态为404的响应。那是因为基于安全考虑默认情况下应用程序是禁用目录访问功能的。目录浏览就是允许网站用户看到指定目录下的目录和文件列表。我们可以通过注册一个名为DirectoryBrowserMiddleware 的中间件来显示请求目录的内容Step1. 在Startup.ConfigureServices 中调用 AddDirectoryBrowser 扩展方法添加目录浏览服务public void ConfigureServices(IServiceCollection services){ services.AddDirectoryBrowser();}Step2. 然后在 Startup.Configure 中调用 UseDirectoryBrowser 扩展方法使用中间件来开启网络应用目录浏览public void Configure(IApplicationBuilder app, IHostingEnvironment env){ app.UseStaticFiles(); app.UseStaticFiles(new StaticFileOptions() { FileProvider new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), MyStaticFiles)), RequestPath new PathString(/StaticFiles), }); app.UseDirectoryBrowser(new DirectoryBrowserOptions() { FileProvider new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), MyStaticFiles)), RequestPath new PathString(/StaticFiles), });}运行程序后就可以通过访问 http:app/StaticFiles 来浏览 ContentRoot/StaticFiles 文件夹中的目录了。这个中间件会返回一个HTML页面将请求目录下的所有文件将以表格的形式包含在这个页面中包括该文件夹下的每一个文件夹与文件注意使用静态文件和目录浏览的区别上述Step2.Startup.Configure方法中调用了两个 app.UseStaticFiles第一个调用允许请求 wwwroot 文件夹下的静态文件第二个调用则是允许通过 http:app/StaticFiles/fileName 请求 StaticFiles 文件夹中的静态文件调用 app.UseDirectoryBrowser 则是允许通过 http:app/StaticFiles 请求浏览 StaticFiles 文件夹的目录。注册指定目录的浏览 app.UseDirectoryBrowser 方法可接受一个配置项对象 DirectoryBrowserOptions该对象与静态文件中间件配置项对象相似通过该对象可以配置允许用户浏览的目录和请求的虚拟路径。 默认文件设置默认首页能给站点的每个访问者提供一个默认起始页。为了使站点能够提供默认页面避免用户输入完整URL我们可以在 Startup.Configure 中调用 app.UseDefaultFiles 扩展方法public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory){ app.UseDefaultFiles(); app.UseStaticFiles();}app.UseDefaultFiles 必须是在 UseStaticFiles 之前调用。UseDefaultFiles只是重写了URL而不是真的提供了这样一个文件。因此必须开启静态文件中间件UseStaticFiles)来提供这个文件。通过 UseDefanltFiles请求文件夹的时候将检索以下文件default.htmdefault.htmlindex.htmindex.html列表中第一个被找到的文件将返回给用户作为该完整URL的请求的应答而此时浏览器上URL将继续显示用户输入的URI。指定默认文件静态文件中间件可以接受一个 DefaultFilesOptions 的配置对象参数通过添加默认主页名称可以指定自定义的默认文件默认首页下面的代码展示如何将默认文件名改为 myindex.htmlpublic void Configure(IApplicationBuilder app){ DefaultFilesOptions options new DefaultFilesOptions(); options.DefaultFileNames.Clear(); // 清除默认文件 options.DefaultFileNames.Add(login.html); //添加指定文件为默认文件 app.UseDefaultFiles(options); //使用默认文件中间件 app.UseStaticFiles(); //使用静态文件中间件必须}在 web根目录中添加好 login.html 页面运行程序UseFileServerUseFileServer 集合了 UseStaticFiles、UseDefaultFiles以及UseDirectoryBrowser。下面的代码启用了静态文件和默认文件但不允许直接访问目录下面的代码启用了静态文件、默认文件和目录浏览功能app.UseFileServer(enableDirectoryBrowsing:true);作为一个集合了UseStaticFiles、UseDefaultFiles和UseDirectoryBrowser方法于一体的方法如果希望提供 web根目录之外存在的文件则需要实例化并配置一个 FileServerOptions 对象传递给app.UscFileServer 的参数。例如在应用中有如下层次的目录mxfile userAgentMozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.89 Safari/537.36 version8.5.3 editorwww.draw.io typedevicediagram7Vtdk5owFP01PnaHEEB9rPbroZ3pdDvT5ygR00ZCQyxuf31vIBHZ6K6tQN1ddpydcMNHcs89h9wbHeH5Zvdekmz9ScSUj3wv3o3wm5HvY8D/9pwVxkCNK4MiWRxZfJqwy37TSsjstYti2neOFEJwRXLjBFVxqVIU7pUjROJlKJoXrsSPG5cl5GEOobbJeGu9RuL1bqyTvxxbf9AWbI2T0YomlY9C7L8kUixTc3zRj5elX9V94bYe5mR5WsSiLAhNO8FwKoarWZjenXLu26bZ3J3r345Y0Vedc4FcX/CJ8S2Iy3GpOsLGGKmm3BTxQj/Av4maaJ7Z0pk0OFBi9OVMk1p/KLbC6GU2JgDwlmSQrs6d/aLwv3A5aNubzZbMU4nwsuJFhSkeqn5BlZsjT5WD0i8mrTF/OoAEwC7rfipS/XLI5pqociFFFkUc5EX5YJlqoyNMIZfMA1c8mHIUwzTkco/oYPvp0qeYizZUkrHQnJbkqaK5HH0uRfSUyoXaqK5EqE8gIYJy5SBhw9Lzp7sBkkHlPxYYqeQenmN7QBIkl0WRSHRd1SCIbSOuDcPQjwwTDgmR/5zoSoGGC4Xhg4IsCo3SGOROdCpRGcBzB/ax4aQZH0FZsPAa/nrOZ2PAyeA3uXGUZDAxoBcYB4GHUDePA44JxVfFRS/NjrIvon8DYAAz8g99cyQF4hB1HsIoqPoMfJgvLPImeKCX1/I0J/iWoHHEZe1CRxhBwSW98fQjq5HNFw0PYno0hwv1pezRoe2vaHp4A/qq0fTwowZNRAjzpUQkmgxK0pgTjE8BflRJMByV4MkoQeNPlMBWXgYpaEEKpieQvyopQMhBvCiKsvTkR1zPeSGhlaj9FA9CAeal7Wu14cYrVVZ4D9EHQF6Ct6h8KDUs1kzRWwBXP7OQJCtB3KYxjQ2ELXAO4Xv5WRg6pAuOcc5rAQE354bwUzCZl4aCrWzZNVDk9QfCGWnyUPhoofBxZF3bUeEDuQnup7tb8BtbvmOc5sXRyiYNp0HvdHpDOSiYFIf4p743vESnojUhuuqBgnjdZmjxfDvk4/G8c8s9YhQ8cuvxlhKdXxzy3WX2gqXPlz7IhuyntXfgtoeqBPx2s5u8LqgT7uRrRYfH859Ak8d9O/M/q4qdBnKTLtje9aEZNl2N3i7Yzl12FzcUZHstyGL3VdZZQfbCTbuhINv4Bk50AvqrqsheuB03iEGvYnCkRtmdGFy2bzeIQUMMJiegvyoxwG7e6EA5DIt5DLYXWB3lMvgYmp2eRpABv93Ao7/Vd5Of/XcAIKsl3daXeFbtyNoodMMMhFvaH0craYEGqWxkOLRgrfHzGt6kHLl/O5dDrrS6B3b1bBgG7uymZcs0sOvLac0B4IFetwqaut9RaYlFcFj/DqbsO/itEX77Bw/diagram/mxfile对于上面这个层次结构的示例你可能需耍启用静态文件、默认文件以及浏览 MyStaticFiles 目录等功能。下面的代码片段演示了如何通过调用一次 FileServerOptions 来完整实现这些功能public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory){ app.UseFileServer(new FileServerOptions() { FileProvider new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), MyStaticFiles)), RequestPath new PathString(/StaticFiles), EnableDirectoryBrowsing true, EnableDefaultFiles true, });}如果将 enableDirectoryBrowsing设置为true则必须要在 Startup.ConfigureServices 中调用 services.AddDirectoryBrowser 扩展方法public void ConfigureServices(IServiceCollection services){ services.AddDirectoryBrowser();}如果在 MyStaticFiles 目录下存在默认页面则打开默认页面。如果没有默认命名的文件则http://StaticFiles将返回目录 StaticFiles 的目录列表如下图所示。StaticFiles中存在默认页面StaticFiles中不存在默认页面FileExtensionContentTypeProviderFileExtensionContentTypeProvider 类内包含一个将文件扩展名映射到 MIME内容类型的集合。在下面的例子中将多个文件扩展名如.myapp注册为已知的MIME类型application/x-msdownload“.rtf”被替换“.mp4”被移除public void Configure(IApplicationBuilder app){ FileExtensionContentTypeProvider provider new FileExtensionContentTypeProvider(); provider.Mappings[.myapp] application/x-msdownload; provider.Mappings[.htm3] text/html; provider.Mappings[.image] image/png; provider.Mappings[.rtf] application/x-msdownload; provider.Mappings.Remove(.mp4); app.UseStaticFiles(new StaticFileOptions() { FileProvider new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), MyStaticFiles)), RequestPath new PathString(/StaticFiles), ContentTypeProvider provider, }); app.UseDirectoryBrowser(new DirectoryBrowserOptions() { FileProvider new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), MyStaticFiles)), RequestPath new PathString(/StaticFiles), });}非标准的内容类型ASP.NET Core 静态文件中间件能够支持超过400多种己知的文件内容类型。如果用户请求一个未知的文件类型静态文件中间件将返 HTTP404(未找到响应。如果启用目录浏览则该文件的URL将会被显示但访问URL会返回一个 HTTP404 错误。下面则通过代码把不能识别的类型和文件作为下载的文件处理public void Configure(IApplicationBuilder app){ app.UseStaticFiles(new StaticFileOptions() { FileProvider new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), MyStaticFiles)), RequestPath new PathString(/StaticFiles), ServeUnknownFileTypes true, DefaultContentType application/x-msdownload, }); app.UseDirectoryBrowser(new DirectoryBrowserOptions() { FileProvider new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), MyStaticFiles)), RequestPath new PathString(/StaticFiles), });}注意事项UseDirectoryBrowser 和 UseStaticFiles 可能会泄密。建议不要在生产环境开启目录浏览。要小心那些被你开启了 UseStaticFiles 或 UseDirectoryBrowser 的目录它们的子文件及子目录都可被访问。建议将公开内容放在content root/wwwroot 这样的目录中远离应用程视图、配置文件等。使用 UseDirectoryBrowser 和 UseStaticFiles 暴露的文件的 URL是否区分大小写以及字符限制受制于底层文件系统。比如Windows是不区分大小写的但MACOS和Linux则区分大小写。实战简单文件服务器① 首先新建一个ASP.NETCore项目选择空的模板。② 使用NuGet命令添加Microsoft.AspNetCore.StaticFiles引用Install-PackageMicrosoft.AspNetCore.StaticFiles③ 如果我们的文件服务器需要能访问和浏览E盘的所有文件与文件夹那么我们就需要用到 UseStaticFiles和 UseDirectoryBrowser 方法了在 Startup.Configure 方法下添加如下代码public void Configure(IApplicationBuilder app){ FileExtensionContentTypeProvider provider new FileExtensionContentTypeProvider(); provider.Mappings[.log] text/plain; app.UseStaticFiles(new StaticFileOptions() { FileProvider new PhysicalFileProvider(E:\), // 指定静态文件目录 ServeUnknownFileTypes true, ContentTypeProvider provider, DefaultContentType application/x-msdownload, // 设置未识别的MIME类型一个默认z值 }); app.UseDirectoryBrowser(new DirectoryBrowserOptions() { FileProvider new PhysicalFileProvider(E:\), // 制定目录这里指定 E盘也可以是其他目录 });}然后运行程序这里选择使用 Kestrel访问http://ip:5000/如下图所示这样我们就能通过客户端浏览服务器E盘的所有文件及文件夹了。我们还手动设置了未识别的 MIME 类型一个默认值application/x-msdownload当浏览器打开这些未识别类型的文件就会下载这些文件。像 .log 这样的文件就被手动设置为文本方式浏览器会直接展示出来。这样我们也就实现了一个简单的文件服务器。如果想用局域网内其他电脑或手机查看图片或视频文件则修改Properties文件下 launchSettings.json 配置文件中的应用程序URL就可以实现WebApplication: {commandName: Project,launchBrowser: true,applicationUrl: https://*:5001;http://*:5000, // 这样就可以通过 http:ip:5000访问environmentVariables: {ASPNETCORE_ENVIRONMENT: Development }}这样在同一局域网内在手机上访问 http:ip:5000就能访问服务器E盘中的文件了。参考原文Microsoft 文档 ASP.NET Core 中间件ASP.NET Core 中间件Middleware详解原文地址https://www.cnblogs.com/anayigeren/p/10282441.html.NET社区新闻深度好文欢迎访问公众号文章汇总 http://www.csharpkit.com
