您的位置:首页 > 编程语言 > ASP

ASP.NET Core 2 学习笔记

2018-05-25 23:07 751 查看

之前的ASP.NET网站,只要把

*.html
*.css
*.jpg
*.png
*.js
等静态文件放在项目根目录,默认都可以直接被浏览;但ASP.NET Core 小改了浏览静态文件的方式,默认根目录不再能浏览静态文件,需要指定静态文件的目录,才可以被浏览。
本篇将介绍ASP.NET Core浏览静态文件的方法。

试着在项目根目录及wwwroot目录中加入静态文件,例如:

项目根目录\index.html

项目根目录\wwwroot\index.html

然后在网址栏输入:

  • http://localhost:5000/index.html
  • http://localhost:5000/wwwroot/index.html

    会发现以上两个链接都没有办法打开index.html。

浏览静态文件,需要

Microsoft.AspNetCore.StaticFiles
中间件,ASP.NET Core 2.0以上版本默认包含。

启用静态文件

在Startup.cs的

Configure
IApplicationBuilder
使用
UseStaticFiles
方法注册静态文件的Middleware:

Startup.cs

UseStaticFiles
默认启用静态文件的目录是wwwroot,设定完成后再次尝试开启URL:

  • http://localhost:5000/index.html

    开启的内容会是:wwwroot目录的index.html。
  • http://localhost:5000/wwwroot/index.html

    依然无法显示静态文件。

UseStaticFiles
注册的顺序可以在外层一点,比较不会经过太多不必要的Middleware。如图:

当Requset的URL文件不存在,则会转向到

Run
的事件(如灰色箭头)。

变更网站目录

默认网站目录是wwwroot,如果想要变更此目录,可以在Program.cs的WebHost Builder用

UseWebRoot
设置网站默认目录。
例如:把默认网站目录wwwroot改为public,如下:

启用指定目录

由于

UseStaticFiles
只能拿到默认文件夹底下的文件,某些情况会需要特定目录也能使用静态文件。
例如:用npm安装的第三方库都放在项目目录底下的node_modules。

Startup.cs

以上设定就会把URL 

http://localhost:5000/third-party/example.js
指向到项目目录\node_modules\example.js。

默认文件

比较友好的用户体验会希望

http://localhost:5000/
可以自动指向到index.html。
能通过
UseDefaultFiles
设定静态文件目录的默认文件。

Startup.cs

  • UseDefaultFiles
    的职责是尝试请求默认文件。
  • UseStaticFiles
     的职责是回传请求的文件。

UseDefaultFiles
必须注册在
UseStaticFiles
之前。
如果先注册
UseStaticFiles
,当URL是/时,
UseStaticFiles
找不到该文件,就会直接回传找不到;所以就没有机会进到
UseDefaultFiles

自定义默认文件

UseDefaultFiles
的默认文件如下:

  • default.htm
  • default.html
  • index.htm
  • index.html

如果默认文件的文件名不在上列清单,也可以自定义要用什么名称当作默认文件。

通过DefaultFilesOptions
设定后,传入
UseDefaultFiles

Startup.cs

文件清单

基本上为了网站安全性考量,不应该让使用者浏览服务器上面的文件清单,但如果真有需求要让使用者浏览文件清单也不是不行。

在Startup.cs的

Configure
IApplicationBuilder
使用
UseFileServer
方法注册文件服务器的功能:

Startup.cs

当打开

http://localhost:5000/StaticFiles
时,就指向到项目目录\bin\目录,并且可以直接浏览文件目录及文件内容,如下: 

参考

 Working with static files in ASP.NET Core

内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: