網(wǎng)站首頁 編程語言 正文
靜態(tài)文件(HTML,CSS,圖片和Javascript之類的資源)會被ASP.NET Core應(yīng)用直接提供給客戶端。
靜態(tài)文件通常位于網(wǎng)站根目錄(web root) <content-root>/wwwroot文件夾下。通常會把項目的當(dāng)前目錄設(shè)置為Content root,這樣項目的web root就可以在開發(fā)階段被明確。
public static IWebHostBuilder CreateWebHostBuilder(string[] args) => WebHost.CreateDefaultBuilder(args) .UseContentRoot(Directory.GetCurrentDirectory()) //設(shè)置當(dāng)前目錄 .UseStartup<Startup>();
靜態(tài)文件能夠被保存在網(wǎng)站根目錄下的任意文件夾內(nèi),并通過相對根的路徑來訪問。使用vs創(chuàng)建一個默認的Web應(yīng)用程序時,在wwwroot目錄下會生成幾個文件夾:css,images,js。如果壓迫訪問images目錄下的圖片:
http://<app>/iamges/filename
https://localhost:44303/iamges/filename
要想使用靜態(tài)文件服務(wù),必須配置中間件,把靜態(tài)文件中間件加入到管道。靜態(tài)文件一般會默認配置,在Configure方法中調(diào)用app.UseStaticFiles()。
app.UseStaticFiles() 使得web root(默認為wwwroot)下的文件可以被訪問。同時可以通過UseStaticFiles方法將其他目錄下的內(nèi)容也可以向外提供:
假如wwwroot外面有一個MyStaticFiles文件夾,要訪問文件夾里面的資源test.png:
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory) { app.UseHttpsRedirection(); app.UseStaticFiles(); app.UseStaticFiles(new StaticFileOptions() { FileProvider = new PhysicalFileProvider( Path.Combine(Directory.GetCurrentDirectory(), @"MyStaticFiles")), //用于定位資源的文件系統(tǒng) RequestPath = new PathString("/StaticFiles") //請求地址 }); }
可以通過訪問
http://<app>/StaticFiles/test.png
https://localhost:44303/StaticFiles/test.png
1.靜態(tài)文件授權(quán)
靜態(tài)文件組件默認不提供授權(quán)檢查。任何通過靜態(tài)文件中間件訪問的文件都是公開的。要想給文件授權(quán),可以將文件保存在wwwroot之外,并將目錄設(shè)置為可被靜態(tài)文件中間件能夠訪問,同時通過一個controller action來訪問文件,在action中授權(quán)后返回FileResult
。
2.目錄瀏覽
目錄瀏覽允許網(wǎng)站用戶看到指定目錄下的目錄和文件列表。基于安全考慮,默認情況下是禁止目錄訪問功能。在Startup.Configure中調(diào)用UseDirectoryBrowser擴展方法可以開啟網(wǎng)絡(luò)應(yīng)用目錄瀏覽:
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory) { app.UseStaticFiles(); app.UseDirectoryBrowser(new DirectoryBrowserOptions() { FileProvider = new PhysicalFileProvider( Path.Combine(Directory.GetCurrentDirectory(),@"wwwroot\images")), RequestPath = new PathString("/MyImages") //如果不指定RequestPath,會將PhysicalFileProvider中的路徑參數(shù)作為默認文件夾,替換掉wwwroot }); }
然后在Startup.CongigureServices中調(diào)用AddDirectoryBrowser擴展方法。
這樣就可以通過訪問http://<app>/MyImages瀏覽wwwroot/images文件夾中的目錄,但是不能訪問文件:
要想訪問具體文件需要調(diào)用UseStaticFiles配置:
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory) { app.UseStaticFiles(); app.UseStaticFiles(new StaticFileOptions() { FileProvider = new PhysicalFileProvider( Path.Combine(Directory.GetCurrentDirectory(), @"wwwroot\images")), //用于定位資源的文件系統(tǒng) RequestPath = new PathString("/MyImages") }); app.UseDirectoryBrowser(new DirectoryBrowserOptions() { FileProvider = new PhysicalFileProvider( Path.Combine(Directory.GetCurrentDirectory(),@"wwwroot\images")), RequestPath = new PathString("/MyImages") }); }
3.默認文件
設(shè)置默認首頁能給站點的訪問者提供一個起始頁,在Startup.Configure中調(diào)用UseDefaFiles擴展方法:
app.UseDefaultFiles(options); app.UseStaticFiles();
UseDefaultFiles必須在UseStaticFiles之前調(diào)用。UseDefaultFiles只是重寫了URL,而不是真的提供了一個這樣的文件,瀏覽器URL將繼續(xù)顯示用戶輸入的URL。所以必須開啟靜態(tài)文件中間件。而且默認文件必須放在靜態(tài)文件中間件可以訪問得到的地方,默認是wwwroot中。
通過UseDefaultFiles,請求文件夾的時候檢索以下文件:
default.htm
default.html
index.htm
index.html
也可以使用UseDefaultFiles將默認頁面改為其他頁面:
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } else { app.UseExceptionHandler("/Home/Error"); app.UseHsts(); } app.UseHttpsRedirection(); DefaultFilesOptions options = new DefaultFilesOptions(); options.DefaultFileNames.Clear(); options.DefaultFileNames.Add("mydefault.html"); app.UseDefaultFiles(options); app.UseStaticFiles(); app.UseMvc(routes => { routes.MapRoute( name: "default", template: "{controller=Home}/{action=Index}/{id?}"); }); }
4.UseFileServer
UseFileServer集合了UseStaticFiles,UseDefaultFiles,UseDirectoryBrowser。
調(diào)用app.UseFileServer(); 請用了靜態(tài)文件和默認文件,但不允許直接訪問目錄。需要調(diào)用app.UseFileServer(enableDirectoryBrowsing:true); 才能啟用目錄瀏覽功能。
如果想要訪問wwwroot以外的文件,需要配置一個FileServerOptions對象
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory) { app.UseStaticFiles();//如果不調(diào)用,將不會啟動默認功能。 app.UseFileServer(new FileServerOptions() { FileProvider = new PhysicalFileProvider( Path.Combine(Directory.GetCurrentDirectory(), @"MyStaticFiles")), RequestPath = new PathString("/StaticFiles"), EnableDirectoryBrowsing = true }); }
注意,如果將enableDirectoryBrowsing設(shè)置為true,需要在ConfigureServices中調(diào)用services.AddDirectoryBrowser();
如果默認文件夾下有默認頁面,將顯示默認頁面,而不是目錄列表。
5.FileExtensionContentTypeProvider
FileExtensionContentTypeProvider類包含一個將文件擴展名映射到MIME內(nèi)容類型的集合。
例如:
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory) { var provider = new FileExtensionContentTypeProvider(); provider.Mappings[".htm3"] = "text/html"; provider.Mappings["images"] = "iamge/png"; provider.Mappings.Remove(".mp4"); app.UseStaticFiles(new StaticFileOptions() { FileProvider = new PhysicalFileProvider( Path.Combine(Directory.GetCurrentDirectory(), @"MyStaticFiles")), RequestPath = new PathString("/StaticFiles"), ContentTypeProvider = provider }); }
更多MIME類型可以訪問:http://www.iana.org/assignments/media-types/media-types.xhtml
6.非標準的內(nèi)容類型
如果用戶請求了一個未知的文件類型,靜態(tài)文件中間件將會返回HTTP 404響應(yīng)。如果啟用目錄瀏覽,則該文件的鏈接將會被顯示,但RUI會返回一個HTTP404錯誤。
使用UseStaticFiles方法可以將未知類型作為指定類型處理:
app.UseStaticFiles(new StaticFileOptions() { ServeUnknownFileTypes = true, DefaultContentType = "application/x-msdownload" });
對于未識別的,默認為application/x-msdownload,瀏覽器將會下載這些文件。
原文鏈接:https://www.cnblogs.com/afei-24/p/10753222.html
相關(guān)推薦
- 2022-12-07 C++中的自定義函數(shù)返回類型_C 語言
- 2022-06-29 python循環(huán)神經(jīng)網(wǎng)絡(luò)RNN函數(shù)tf.nn.dynamic_rnn使用_python
- 2023-09-17 org.apache.ibaorg.apache.ibatis.btis.binding.Bindi
- 2022-04-11 Entity?Framework?Core工具使用命令行_基礎(chǔ)應(yīng)用
- 2023-07-05 docker容器部署nginx外網(wǎng)不通端口監(jiān)聽只有tcp6沒走tcp問題
- 2022-07-12 Linux命令之美|linux使用tar誤解壓之后,如何刪除解壓后的文件
- 2022-08-15 使用enum關(guān)鍵字定義的枚舉類實現(xiàn)接口的情況
- 2022-06-18 C#如何綁定多個按鈕到同一個事件_C#教程
- 最近更新
-
- window11 系統(tǒng)安裝 yarn
- 超詳細win安裝深度學(xué)習(xí)環(huán)境2025年最新版(
- Linux 中運行的top命令 怎么退出?
- MySQL 中decimal 的用法? 存儲小
- get 、set 、toString 方法的使
- @Resource和 @Autowired注解
- Java基礎(chǔ)操作-- 運算符,流程控制 Flo
- 1. Int 和Integer 的區(qū)別,Jav
- spring @retryable不生效的一種
- Spring Security之認證信息的處理
- Spring Security之認證過濾器
- Spring Security概述快速入門
- Spring Security之配置體系
- 【SpringBoot】SpringCache
- Spring Security之基于方法配置權(quán)
- redisson分布式鎖中waittime的設(shè)
- maven:解決release錯誤:Artif
- restTemplate使用總結(jié)
- Spring Security之安全異常處理
- MybatisPlus優(yōu)雅實現(xiàn)加密?
- Spring ioc容器與Bean的生命周期。
- 【探索SpringCloud】服務(wù)發(fā)現(xiàn)-Nac
- Spring Security之基于HttpR
- Redis 底層數(shù)據(jù)結(jié)構(gòu)-簡單動態(tài)字符串(SD
- arthas操作spring被代理目標對象命令
- Spring中的單例模式應(yīng)用詳解
- 聊聊消息隊列,發(fā)送消息的4種方式
- bootspring第三方資源配置管理
- GIT同步修改后的遠程分支