ASP.NET5 静态文件

静态文件,包括HTML文件,CSS文件,图像文件和JavaScript文件,它是一个应用里所包含的资源。

1. 提供静态文件

默认的,静态文件存储在你的webroot目录下面,webroot的路径定义在project.json里面

"webroot": "wwwroot"

静态文件可以被存储在webroot下面的任何目录当中,以一个相对目录获取到。在一个默认的web应用程序当中,在webroot下面默认有三个目录css, images和js. 要获取图像路径,格式如下:

http://<yourApp>/images/<imageFileName>

为了应用静态文件,你必须在Configure方法中注册

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)

{

  app.UseStaticFiles();

}

如果你有不在webroot目录下的静态文件需要添加,如何做呢

假如文件目录如下:

* wwwroot

  *css

  *images

  *....

*MyStaticFiles

  * test.png

要获取test.png,如何做呢,我们需要在Configure添加如下的代码:

app.UseStaticFiles(new StaticFileOptions()

{

  FileProvider = new PhysicalFileProvider(@"D:\Source\WebApplication1\src\WebApplciation1\MyStaticFiles"),

  RequestPath = new PathString("/StaticFiles")

});

这样,用户就可以通过http://<yourApp>/StaticFiles/test.png来获取test.png文件了.

2. 使目录可预览

上当浏览可以使用户浏览你的目录和子目录信息,默认的这个功能是关闭的,要使其打开,可以在COnfigure里增加如下代码:

app.UseDirectoryBrowser();

同样的,webroot目录以外的静态资源要被浏览,做如下配置:

app.UseDirectoryBrowser(new DirectoryBrowserOptions()

{

  FileProvider = new PhysicalFileProvider(@"..."),

  RequestPath = new PathString("/StaticFiles")

});

你可以通过http://<yourApp>/StaticFiles去浏览.

3. 提供默认的文件

为了不输入全路径而要显示默认的文件,可以通过UseDefaultFiles扩展方法来扩展。注意,你还必须调用UseStaticFIles,这是因为UseDefaultFile是URL重写,他实际上不提供文件。

app.UseDefaultFiles();

app.UseStaticFiles();

如果你用了UseDefaultFiles, 中间件会找如下的页面作为默认页面。

*default.htm

*default.html

*index.htm

*index.html

要定义自己的默认文件,代码如下:

DefaultFileOptions options = new DefaultFileOptions();

options.DefaultFileNames.Clear();

options.DefaultFileNames.Add("mydefault.html");

app.UseDefaultFiles(options);

app.UseStaticFiles();

如果你想用一个默认的页面在webroot之外,你也必须再调用一下UseStaticFiles, UseDefaultFiles方法传参数进去。这样比较麻烦,可以用UseFileServer代替

4. UseFileServer方法

UseFileServer方法可以合并UseStaticFiles, UseDefaultFiles和UseDirectoryBrowser方法。

app.UseFileServer();   或者 app.UseFileServer(enableDirectoryBrowsing: true);

你要在webroot以处定义你的静态文件,代码如下:

app.UserFileServer(new FileServerOptions()

{

  FileProvider = new PhysicalFileProvider(@"D:\Source\WebApplication1\src\WebApplication1\MyStaticFiles"),

  RequestPath = new PathString("/StaticFiles"),

  EnableDirectoryBrowsing = true

});

5. Content types

ASP.NET提供了差不多400多个文件类型,如果你试图访问一个未知的文件类型,ASP.NET中间件不会提供这个文件。

例如有一个文件路径

* wwwroot

  * images

    *test.image

如果你访问http://<yourApp>/images/test.image, 你会得到一个404的错误,尽管这个文件实际上存在。你可以当开这个限制,如下所示:

app.UseStaticFiles(new StaticFileOptions

{

  ServerUnknownFileTypes = true,

  DefaultContentType = "image/png"

});

这样,如果用户浏览一个未定义的文件格式,浏览器会以一个图片的格式在渲染它。

如果你有很多的文件类型是ASP.NET不知道,该怎么做呢?FileExtensionContentTypeProvider类可以帮助你。代码如下:

var provider = new FileExtensionContentTypeProvider();

provider.Mappings.Add(".myapp", "application/x-msdownload");

app.UseStaticFiles(new StaticFileOptions{ ContentTypeProvider = provider});

这样,如果用户请求.myapp的文件,浏览器会下载该文件.

6. IIS

IIS有个本地的静态文件的模块,它独立于ASP.NET的静态文件,ASP.NET模块在IIS本地模块之前运行,在ASP.NET Beta7 , IIS 宿主改变了,如果ASP.NET不处理,IIS本地模块也不处理。如果要选择执行IIS本地的模块,需要执行如下代码:

app.RunIISPipeline();

注意:代码文件应该放在webroot之外,这样可以把静态文件和动态文件区分开来。

时间: 2024-12-19 06:51:37

ASP.NET5 静态文件的相关文章

ASP.NET5 中静态文件的各种使用方式

所谓静态文件,包含HTML文件,css文件.图片文件和js文件等,他们是服务器直接读取到客户端的一些资源,在这篇文章中,我们将解释关于ASP.NET5和静态文件的一些内容. 服务端的静态文件 默认情况下,静态文件被存放在项目的wwwroot目录下,而wwwroot的地址被定义在project.json文件中: { "webroot": "wwwroot", ... } 静态文件被存储在wwwroot下的任何目录中,它被客户端以相对路径的方式访问,例如,当你在Visu

Dotnet Core 在ASP.NET Core中使用静态文件

来自微软官网  在ASP.NET Core中使用静态文件:https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/static-files: 提供静态文件 静态文件通常位于web root(<content-root> / wwwroot)文件夹中.有关详细信息,请参阅内容根和Web根.您通常将内容根设置为当前目录,以便web root在开发过程中找到项目. public static void Main(string[] args)

ASP.NET Core 1.1 静态文件、路由、自定义中间件、身份验证简介

概述 之前写过一篇关于<ASP.NET Core 1.0 静态文件.路由.自定义中间件.身份验证简介>的文章,主要介绍了ASP.NET Core中StaticFile.Middleware.CustomizeMiddleware和Asp.NetCore Identity.但是由于所有的ASP.NET Core的版本有些老,所以,此次重写一次.使用最新的ASP.NET Core 1.1版本.对于ASP.NET Core 1.1 Preview 1会在以后的文章中介绍 目录 使用静态文件 使用路由

ASP.NET Core应用针对静态文件请求的处理[5]: DefaultFilesMiddleware中间件如何显示默认页面

DefaultFilesMiddleware中间件的目的在于将目标目录下的默认文件作为响应内容.我们知道,如果直接请求的就是这个默认文件,那么前面介绍的StaticFileMiddleware中间件会将这个文件响应给客户端.如果我们能够将针对目录的请求重定向到这个默认文件上,一切就迎刃而解了.实际上DefaultFilesMiddleware中间件的实现逻辑很简单,它采用URL重写的形式修改了当前请求的地址,即将针对目录的URL修改成针对默认文件的URL.[本文已经同步到<ASP.NET Cor

利用一个ASP.NET Core应用来发布静态文件

虽然ASP.NET Core是一款"动态"的Web服务端框架,但是在很多情况下都需要处理针对静态文件的请求,最为常见的就是这对JavaScript脚本文件.CSS样式文件和图片文件的请求.针对不同格式的静态文件请求的处理,ASP.NET Core为我们提供了三个中间件,它们将是本系列文章论述的重点.不过在针对对它们展开介绍之前,我们照理通过一些简单的实例来体验一下如何在一个ASP.NET Core应用中发布静态文件.[本文已经同步到<ASP.NET Core框架揭秘>之中]

细说ASP.NET Core静态文件的缓存方式

2016-11-26 张磊 dotNET跨平台 一.前言 我们在优化Web服务的时候,对于静态的资源文件,通常都是通过客户端缓存.服务器缓存.CDN缓存,这三种方式来缓解客户端对于Web服务器的连接请求压力的. 本文指在这三个方面,在ASP.NET Core中静态文件的实现过程和使用方法进行阐述.当然也可以考虑使用反向代理的方式(例如IIS或Nginx),这些不是本文讨论的内容. 本文重点展示如何通过StaticFileMiddleware中间件,提高网站的性能.虽然这不是唯一缓存文件的方式,我

ASP.NET Core应用针对静态文件请求的处理[2]: 条件请求与区间请求

通过调用ApplicationBuilder的扩展方法UseStaticFiles注册的StaticFileMiddleware中间件帮助我们处理针对文件的请求.对于StaticFileMiddleware处理请求的逻辑,大部分读者都应该想得到:它根据请求的地址找到目标文件的路径,然后利用注册的ContentTypeProvider根据路径解析出与文件内容相匹配的媒体类型,默认情况下得到的媒体类型是根据目标文件的扩展名解析出来的.解析出来的媒体类型将作为响应报头Content-Type的值.St

ASP.NET 5中的静态文件处理

ASP.NET 5 与之前的 ASP.NET 相比,有着翻天覆地的变化.了解与熟悉它需要一个过程,而我选择的了解方式是一步一步从无而有手写一个简单的 ASP.NET 5 程序,然后根据遇到的问题进行学习. 这篇博文是关于静态文件(比如图片,css)处理的. 在之前的 ASP.NET 中,只需要将静态文件放到相应的网站目录中就行了,这是由 IIS 进行处理的,在 ASP.NET 程序中可以不用关心. 但是在 ASP.NET 5 中有 2 个不一样的地方. 第一个就是在 ASP.NET 5 中,网站

IIS7.5配置Asp.net项目出现HTTP 错误 404.17 - Not Found 请求的内容似乎是脚本,因而将无法由静态文件处理程序来处理。

近日在将一个Asp.net项目部署到IIS7.5上时却出现了HTTP 错误 404.17 - Not Found 请求的内容似乎是脚本,因而将无法由静态文件处理程序来处理. 因为IIS里面使用的都是默认配置(只是更改了物理路径而已),在网络上找了一圈也没有找到解决办法.最后忽然想到会不会是应用程序池里的.Net Framework版本问题呢? 因为之前安装过4.0的版本,于是打开应用程序池,看到项目使用的应用程序池里的配置信息使用的.Net Framework版本为无托管代码 在将网站的应用程序